当前位置：首页 > news >正文

简单介绍下 Java 中的 @Validated 和 @Valid 注解的区别？

news 2026/3/27 4:47:20

文章目录

- - @Valid：专注单个对象的深度验证
  - - 适用场景
    - 使用示例
    - 小结
  - @Validated：聚焦接口分组的批量验证
  - - 适用场景
    - 使用示例
    - 小结
  - 主要区别总结
  - 如何选择？
  - 总结
  - 推荐阅读文章

在 Java 开发中，为了确保输入数据符合我们的要求，少不了数据验证这一步。 @Valid 和 @Validated 是两个常见的验证注解，它们在 Spring 中常常出现，虽然名字差不多，但作用和使用场景却不太一样。

今天，我们就来聊聊 @Valid 和 @Validated 的区别，看它们如何在验证世界里各司其职，搭配使用！

@Valid：专注单个对象的深度验证

@Valid 是 Java 中的标准验证注解，适用于单个对象的验证。它的职责很清晰——递归地验证这个对象，尤其适用于嵌套对象的场景。

比如，你的表单里有个 User 对象，User 里还有 Address 对象，那么在验证 User 时，如果用了 @Valid，它会一层层地深入到 Address，对所有字段进行完整验证。

适用场景

@Valid 更适合在字段上进行深层次的验证，比如：

方法参数：在方法参数前标注 @Valid，让 Spring 验证参数。
嵌套对象：在对象内部的字段上使用 @Valid，确保递归验证。

使用示例

public class User {@NotNullprivate String name;@Valid // 在嵌套对象 Address 上使用 @Validprivate Address address;
}public class Address {@NotBlankprivate String city;
}

在这个例子中，@Valid 会确保 User 对象的 address 字段也被验证。因此，如果 address 的 city 是空字符串，也会报错。

小结

@Valid 是一种“全家桶”式的验证器，用来递归检查整个对象树的各个字段是否符合要求。

@Validated：聚焦接口分组的批量验证

@Validated 是 Spring 特有的验证注解，和 @Valid 不同的是，它的主要优势在于支持验证分组。分组验证的概念很简单：比如，我们在用户注册时要验证的内容和在用户更新资料时可能不同。@Validated 就允许你给验证分组，灵活地控制哪些验证规则在何时触发。

适用场景

分组验证：需要在不同情况下使用不同的验证规则时，@Validated 是非常合适的选择。

使用示例

假设我们有两个验证场景，一个是 AddGroup（新增用户时的验证），一个是 UpdateGroup（更新用户时的验证），可以这样做：

public class User {@NotNull(groups = AddGroup.class)private String name;@NotBlank(groups = UpdateGroup.class)private String email;
}public interface AddGroup {}
public interface UpdateGroup {}

在控制器方法中，指定使用哪个分组：

@PostMapping("/addUser")
public void addUser(@Validated(AddGroup.class) @RequestBody User user) {// 仅验证 AddGroup 分组
}@PutMapping("/updateUser")
public void updateUser(@Validated(UpdateGroup.class) @RequestBody User user) {// 仅验证 UpdateGroup 分组
}

这样，通过 @Validated 注解和分组，你可以在不同操作中有选择地应用不同的验证逻辑。

小结

@Validated 是一位“分组专家”，适合复杂场景下的批量验证。

主要区别总结

注解	验证对象	支持分组验证	适用场景
`@Valid`	单个对象，递归验证	否	深度验证嵌套对象
`@Validated`	批量验证，可以选择性验证	是	在不同业务场景下应用不同验证逻辑

如何选择？

需要递归验证单个对象的各个字段（尤其是嵌套的复杂对象）：用 @Valid。
需要在不同操作中选择性验证字段（比如新增和更新的验证规则不同）：用 @Validated，并分配分组。

总结

@Valid 是“单体专家”，适合一层层深入对象结构，逐个检查字段。
@Validated 是“分组大拿”，让你灵活控制不同场景下的验证要求。

理解这两个注解的分工后，就可以让你的 Java 应用在数据验证上更严谨、更灵活啦！

文章目录

@Valid：专注单个对象的深度验证

适用场景

使用示例

小结

@Validated：聚焦接口分组的批量验证

适用场景

使用示例

小结

主要区别总结

如何选择？

总结

推荐阅读文章

相关文章：