只需在嵌套对象字段上加@valid注解，配合@notblank等校验注解即可实现级联校验；控制器方法参数需用@valid+@requestbody触发，集合校验需使用list类型注解。
在 Java 的 Spring Boot 项目中，若想对实体类中嵌套的对象字段也执行校验（比如 User 包含一个 Address 对象，且 Address 的字段也需要校验），只需在嵌套对象的字段上加 @Valid 注解即可，配合标准的 Bean Validation 注解（如 @NotBlank、@NotNull 等）就能实现级联校验。
1. 在嵌套字段上标注 @Valid
这是级联校验的关键一步。@Valid 表示该字段本身也要参与校验流程，否则即使内部类有校验注解，也不会触发。
例如：
public class User {
@NotBlank(message = "用户名不能为空")
private String name;
@Valid // ✅ 必须加上，否则 Address 内部校验不生效
private Address address;
// getter/setter...
}
public class Address {
@NotBlank(message = "城市不能为空")
private String city;
@Min(value = 1, message = "邮编必须大于0")
private Integer zipCode;
// getter/setter...
}
2. 控制器中启用校验
Spring MVC 默认支持 @Valid，但需在 Controller 方法参数上显式声明，并配合 @RequestBody 或 @ModelAttribute 使用。如果校验失败，默认会抛出 MethodArgumentNotValidException，可全局捕获处理。
示例：
@PostMapping("/users")
public ResponseEntity<string> createUser(@Valid @RequestBody User user) {
return ResponseEntity.ok("创建成功");
}
</string>
3. 注意嵌套集合的写法
如果嵌套的是集合（如 List
），则@Valid 要加在集合字段上，且集合元素类型本身需有校验注解：
public class User {
@Valid
private List addresses; // ✅ 集合元素也要加 @Valid（Java 8+ 支持类型注解）
}
说明：
-
List是 Java 8 引入的“类型注解”，表示集合中每个 Address 实例都要校验； - 仅写
@Valid private List<address> addresses;</address>不足以触发每个元素的校验，必须配合类型注解或使用@Validated+ 自定义校验逻辑； - Lombok 的
@Data不影响校验，但需确保生成的 getter/setter 完整（尤其是集合字段的 setter）。
4. 常见问题与建议
校验不生效？检查以下几点：
- 嵌套对象字段是否漏了
@Valid； - 是否在 Controller 参数上用了
@Valid或@Validated； - 是否引入了
spring-boot-starter-validation（Spring Boot 2.3+ 后需显式添加）； - 是否用
@RequestBody接收 JSON —— 若用@RequestParam或路径参数，则不走 Bean Validation 流程； - 自定义校验器或分组校验时，确保
@Valid和分组匹配（如@Validated(User.Create.class)）。
Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
