Spring Boot参数校验失效主因是依赖缺失、注解位置错误、嵌套未加@Valid或异常未统一处理；需引入spring-boot-starter-validation，@Valid标注字段及控制器参数，嵌套对象显式加@Valid，全局捕获MethodArgumentNotValidException返回友好提示。
Spring Boot 参数校验报错，本质是校验流程没走通或结果没被正确处理。问题通常不出在注解本身，而在于依赖、位置、触发时机或异常捕获这几个关键环节。找准卡点，就能快速定位。
依赖缺失：最隐蔽也最高发的“失效”原因
Spring Boot 2.3+ 版本默认移除了 spring-boot-starter-validation，即使写了 @Valid，整个校验框架根本没加载——自然不报错也不生效。
- 检查
pom.xml是否显式引入了该依赖（不是可选，是必须）：
- 若用 Gradle，对应添加：
implementation 'org.springframework.boot:spring-boot-starter-validation' - 验证方式：启动项目后，在任意 DTO 字段加
@NotNull并传 null，看是否抛出MethodArgumentNotValidException；不抛就说明依赖未生效。
注解位置与用法错误：校验没被“看见”
校验注解必须写在字段上（不是 getter/setter），且控制器参数需配合 @Valid 或 @Validated 才能触发。
Java 接口排错助手
下载
在调试 Java 后端 API 故障时使用此技能，尤其适用于以下任务：分析日志、跨 Controller、Service 和 Mapper 层追踪请求、定位异常根因、检查 SQL 执行或参数流转，以及生成简洁的诊断结论与修复方案。
-
DTO 内部：所有
@NotBlank、@Email等必须标注在字段声明行，而非方法上 -
Controller 方法参数：
- 接收 JSON（
@RequestBody）→ 必须加@Valid（支持嵌套）或@Validated - 接收 URL 参数（
@RequestParam）→ 只能用@Validated（@Valid不支持） - 路径变量（
@PathVariable）→ 同样只支持@Validated，且 Controller 类需加@Validated注解
- 接收 JSON（
- 常见误写：
@Valid加在Map<string object></string>或泛型类型上——无效，校验只对具体 Java Bean 生效。
嵌套对象校验失效：里层规则“静音”
外层 DTO 字段引用另一个对象时，仅加 @NotNull 不会校验其内部字段；必须显式加 @Valid 才开启递归校验。
- 示例修正：
@NotBlank private String name;
@Valid // 关键！否则 AddressDTO 内部注解全被忽略
@NotNull private AddressDTO address;
}
- 注意：
@Validated不支持嵌套校验，此处不能替换为@Validated - 若 AddressDTO 中还有嵌套对象（如
ProvinceDTO），同样需在对应字段加@Valid
异常未被捕获或格式混乱：前端收不到友好提示
校验失败默认抛 MethodArgumentNotValidException（JSON 请求）或 ConstraintViolationException（URL 参数），但 Spring Boot 默认响应结构不适合前端直接解析。
- 推荐统一用
@ControllerAdvice拦截并转为标准 Result 格式：
public Result handleValidation(Exception ex) {
BindingResult result = ((MethodArgumentNotValidException) ex).getBindingResult();
String msg = result.getFieldErrors().get(0).getDefaultMessage();
return Result.fail(msg);
}
- 避免在 Controller 内手动调用
bindingResult.hasErrors()—— 这绕过了全局异常机制，重复且易漏 - 若用分组校验（如
@Validated(UserGroup.Create.class)），异常类型仍是MethodArgumentNotValidException，无需额外适配
