MethodArgumentNotValidException仅在@RequestBody参数+@Valid/@Validated注解+无BindingResult时抛出；需用@ExceptionHandler精准捕获并返回400及字段级错误信息。
Spring Boot 中参数校验失败默认抛出 MethodArgumentNotValidException，这是 Spring MVC 在处理带有 @Valid 或 @Validated 注解的 @RequestBody 参数时，校验不通过所触发的标准异常。
哪些情况会抛 MethodArgumentNotValidException？
该异常只在以下条件同时满足时才会被抛出：
- 控制器方法参数使用了
@RequestBody（即接收 JSON 请求体） - 该参数类上或字段上添加了如
@NotBlank、@NotNull、@Size等 Bean Validation 注解 - 方法参数前明确标注了
@Valid或@Validated - 没有手动声明
BindingResult参数来“吸收”校验结果（一旦写了BindingResult，Spring 就不会抛异常，而是交由你自行判断）
为什么不能用 Exception 模糊捕获？
虽然 Exception 能兜住 MethodArgumentNotValidException，但这样会失去异常语义和处理精度：
- 无法区分是参数错误（400）还是服务崩溃（500）
- 前端得不到结构化错误字段（如哪个字段错、错误信息是什么）
- 后续想单独处理数据库异常、权限异常等就变得困难
正确捕获方式：@RestControllerAdvice + @ExceptionHandler
推荐在全局异常处理器中精准拦截该异常：
@RestControllerAdvice
public class GlobalExceptionHandler {
@ExceptionHandler(MethodArgumentNotValidException.class)
public Result<Void> handleValidationException(MethodArgumentNotValidException ex) {
// 提取所有校验失败字段和消息
List<String> errors = ex.getBindingResult()
.getFieldErrors()
.stream()
.map(e -> e.getField() + ": " + e.getDefaultMessage())
.collect(Collectors.toList());
return Result.fail(400, "参数校验失败：" + String.join("; ", errors));
}
}
注意：返回状态码应为 400 Bad Request，符合 REST 规范；错误信息建议包含字段名，便于前端定位问题。
其他校验场景对应的不同异常
不是所有校验都走 MethodArgumentNotValidException：
-
@RequestParam或@PathVariable校验失败 → 抛 ConstraintViolationException（需单独捕获） - 使用编程式校验（
Validator.validate()）→ 不抛异常，返回Set<constraintviolation></constraintviolation> - 自定义注解校验逻辑中主动 throw → 通常是自定义业务异常，按需设计
