Spring中@Validated与javax校验注解对控制器参数校验失效问题

1. 注解导入包错误 #

• 确认@NotNull、@NotBlank等校验注解是从javax.validation.constraints包导入，而非org.springframework.lang包（Spring的同名注解仅用于IDE提示，不触发JSR-380校验逻辑）。
• 错误示例：import org.springframework.lang.NotBlank;
• 正确示例：import javax.validation.constraints.NotBlank;

2. @Validated 注解位置错误 #

• @Validated必须标注在控制器类上，仅在方法参数上标注无法触发简单类型参数（如String、Integer）的校验。类级别的@Validated是启用方法级校验的前提。

3. 依赖版本冲突或配置问题 #

• 移除手动指定的hibernate-validator版本号：Spring Boot的spring-boot-starter-validation会自动管理兼容的依赖版本，手动指定6.0.0可能与当前Spring Boot版本不匹配，引发冲突。
• 检查是否重复引入validation相关依赖：比如同时引入validation-api和hibernate-validator，导致类加载混乱。
• Spring Boot 2.3.x及以上版本需手动引入spring-boot-starter-validation，此前版本该依赖包含在spring-boot-starter-web中。

4. 自定义校验配置类问题 #

• 移除自定义的MethodValidationPostProcessor和LocalValidatorFactoryBean配置类：Spring Boot已经自动配置了这些组件，自定义配置可能覆盖默认逻辑导致失效。如果必须自定义，确保MethodValidationPostProcessor的validator属性正确指向LocalValidatorFactoryBean实例。
• 错误示例：未给MethodValidationPostProcessor指定validator，导致使用默认的空校验器。

5. 请求参数绑定类型问题 #

• GET请求的@RequestParam参数：依赖类上的@Validated触发校验。
• POST请求的@RequestBody对象参数：需在参数前额外添加@Valid或@Validated，才能触发对象内部字段的校验（类上的@Validated仅启用方法级校验，不直接触发RequestBody的字段校验）。
• 确认传入参数确实不符合校验规则：比如测试时传入的是空字符串而非null，或者参数名称不匹配导致未绑定到方法参数上。

6. 异常处理器干扰 #

• 检查全局异常处理器是否提前捕获了ConstraintViolationException并静默处理，或者被参数绑定异常（如BindException）抢先抛出，导致误以为校验未触发。
• 在控制器方法开头添加日志打印参数值，确认参数已正确接收且不符合校验规则。

内容的提问来源于stack exchange，提问作者AntonioBuenos