要实现级联校验，须同时满足：①嵌套字段标注@Valid；②嵌套对象内部字段有约束注解（如@NotBlank）；③Controller方法参数加@Valid或@Validated启动校验。

要在参数校验中用 @Valid 触发级联校验，关键不是“加了就生效”，而是满足三个条件：字段上声明 @Valid、嵌套对象自身有约束注解、方法参数上也带 @Valid 或 @Validated 启动校验流程。

嵌套对象字段必须显式标注 @Valid

只在 Controller 参数上加 @Valid 不够，还必须在实体类中对要级联校验的字段加上 @Valid。Spring 会根据这个标记决定是否递归进入该对象内部校验。

• 比如 User 类包含 Profile 字段，就得写：@Valid private Profile profile;
• 如果 Profile 里还有 Address 字段且也要校验，那 Profile 类中也要写：@Valid private Address address;
• 不加 @Valid，即使 Profile 的字段上有 @NotBlank 等注解，也不会被触发

嵌套对象自身需定义有效约束

被 @Valid 标记的对象（如 Profile），其内部字段必须使用标准校验注解（如 @NotBlank、@Min、@Email 等），否则级联校验“有路无灯”，走不到具体规则。

Alibabacloud Sdk Client Initialization For Java

在 Java 中初始化和管理阿里云 SDK客户端。包括单例模式、线程安全、endpoint 与 region 配置、VPC 终端节点、同步与异步等。

下载

• Profile 类中 @NotBlank private String nickname; 才会在 User 校验时一并检查
• 若 nickname 字段没加任何约束注解，哪怕加了 @Valid，也不会报错
• 注意：@Valid 本身不定义规则，只开启“往下查”的开关

Controller 方法参数必须启用校验入口

@Valid 在字段上只是“声明可级联”，真正启动整条校验链，得靠 Controller 方法参数上的 @Valid（或 @Validated）。

• 正确写法：@PostMapping("/user") public ResponseEntity> save(@Valid @RequestBody User user)
• 错误写法：只写 @RequestBody User user —— 即使 User 和 Profile 都标了 @Valid，也不触发任何校验
• 使用 @Validated 效果相同，还支持分组校验，比如 @Validated(Create.class)

集合类型要额外加 @Valid 才能逐元素校验

如果嵌套的是 List 或 Set，不能只靠字段上的 @Valid，还要确保集合本身被标记，否则只校验集合非空，不校验每个元素。

• 例如：@Valid @Size(min = 1) private List<Question> questions;
• Question 类内部字段（如 title）也要有 @NotBlank，且 Question 的 options 字段若也是 List<Option>，则需同样加 @Valid
• 空集合默认跳过元素校验，无需额外处理；但 null 集合会因 @NotNull 失败，和 @Valid 无关