Spring Boot 参数校验失效的五大原因：①缺少 spring-boot-starter-validation 依赖；②误用 javax.validation 而非 jakarta.validation 包；③@Valid 注解放错位置或未对嵌套对象/集合显式标注；④未捕获 MethodArgumentNotValidException 导致异常处理不当；⑤内部方法调用绕过 AOP 代理使 @Validated 失效。
Spring Boot 中参数校验注解（如 @NotBlank、@Valid、@Validated）不生效，不是代码写错了，而是校验机制的“启动条件”没满足。下面这五个原因覆盖了 90% 以上的实际失效场景，按排查优先级从高到低排列。
缺少 spring-boot-starter-validation 依赖
这是最基础也最高发的问题。Spring Boot 2.3+ 版本起，spring-boot-starter-web 不再默认包含校验能力，必须显式引入：
- 检查
pom.xml是否有该依赖（注意 groupId 和 artifactId 拼写）：
<dependency> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-starter-validation</artifactId> </dependency>
- 运行
mvn dependency:tree | grep validator，确认输出中包含jakarta.validation-api和hibernate-validator； - 若存在多个
hibernate-validator或混入javax.validation，说明有依赖冲突，需排除旧版。
导入了错误的验证包路径
Spring Boot 2.7+ 和全部 3.x 版本统一使用 Jakarta EE 9+ 规范，所有注解必须来自 jakarta.validation.constraints.*：
- 检查 DTO 类顶部 import 是否为：
import jakarta.validation.constraints.NotBlank;； - 如果误用了
javax.validation.constraints.NotBlank（常见于老项目迁移或 IDE 自动补全），注解会被完全忽略，无任何提示； - 建议全局搜索
javax\.validation，替换为jakarta\.validation。
@Valid 注解放错位置或漏加
校验注解必须作用在字段上，且嵌套对象/集合需显式标注 @Valid 才能递归校验：
Alibabacloud Sdk Client Initialization For Java
下载
在 Java 中初始化和管理阿里云 SDK客户端。包括单例模式、线程安全、endpoint 与 region 配置、VPC 终端节点、同步与异步等。
立即学习“Java免费学习笔记（深入）”；
- 字段校验：注解写在属性上，不是 getter 方法上；
- 嵌套对象：外层 DTO 中引用 AddressDTO，必须在字段前加
@Valid； - 集合类型：如
List<ItemDTO>，需写成@Valid List<ItemDTO> items； - Controller 入参：
@RequestBody @Valid UserDTO dto缺一不可。
校验异常未被捕获或处理不当
@Valid 校验失败时抛出的是 MethodArgumentNotValidException，不是 ConstraintViolationException：
- 若没有定义
@ControllerAdvice全局异常处理器，Spring Boot 默认返回 HTTP 400，但错误信息格式原始、前端难解析； - 若错误地捕获了
ConstraintViolationException，会导致校验失败被静默吞掉，或转为 500 错误； - 推荐做法：统一捕获
MethodArgumentNotValidException，提取BindingResult中的错误并封装成结构化响应。
内部方法调用绕过了 Spring AOP 代理
当使用 @Validated 对 Service 方法参数做校验时，若该方法被同一类中的其他方法直接调用（非通过 Spring 容器注入的 Bean 调用），AOP 代理不生效：
- 例如：Service 类里
public void save(@Validated User user)被本类另一个doSomething()方法调用； - 此时
@Validated完全不触发； - 解决方式：拆分逻辑、改为跨 Bean 调用，或手动调用
Validator.validate()。
