Spring Boot 2.5.4版本@Valid参数校验注解不生效问题求助

0 检查校验依赖完整性 #

执行mvn dependency:tree命令确认项目中是否存在org.hibernate.validator:hibernate-validator依赖，如果不存在说明spring-boot-starter-validation的传递依赖被其他组件排除，手动引入该依赖即可。 #

1 排查是否使用了@EnableWebMvc注解 #

• 如果你在任意配置类上标注了@EnableWebMvc，Spring Boot 会关闭Web MVC的自动配置能力，默认集成的校验逻辑也会同步失效。直接删除该注解即可恢复默认校验配置，如果确实需要自定义MVC规则，实现WebMvcConfigurer接口即可，不要使用@EnableWebMvc。

2 排查springfox依赖冲突 #

你引入的springfox-bean-validators会和Spring Boot自带的校验逻辑产生冲突，直接移除该依赖即可：

<!-- 从pom.xml中删除以下配置 -->
<dependency>
    <groupId>io.springfox</groupId>
    <artifactId>springfox-bean-validators</artifactId>
    <version>3.0.0</version>
</dependency>

3 排查是否存在自定义Validator覆盖默认配置 #

如果你自定义了Validator实现类并注入到Spring容器，或者在WebMvcConfigurer的getValidator()方法中返回了自定义实例，会导致默认的校验器不生效。检查相关配置，确保没有覆盖默认的校验器即可。 #

4 排查异常是否被全局异常处理器吞掉 #

校验触发后会抛出MethodArgumentNotValidException，如果你配置的全局异常处理器捕获了Exception父类且未对该异常做特殊处理，可能会直接返回成功响应，导致你误以为校验没有触发。你可以在Controller方法入口打断点，观察入参的login字段是否确实为null/空字符串，如果字段值符合违例条件但方法仍能执行，才是校验未触发。 #

5 可选修复方案 #

如果以上排查都没有问题，可以尝试在Controller类上添加Spring的@Validated注解，同时保留方法参数上的@Valid注解，强制触发参数校验。

内容的提问来源于stack exchange，提问作者Hung Nguyen Thuan