spring boot 中 methodargumentnotvalidexception 需通过 @controlleradvice 全局捕获，配合 @valid 注解和 jsr-303 校验规则生效，遗漏 @valid、分组不匹配、扫描路径错误或 validator 配置不当均会导致校验失效。
在 Spring Boot 中，当使用 @Valid 或 @Validated 注解校验控制器方法参数（如 @RequestBody 对象）失败时，Spring 会自动抛出 MethodArgumentNotValidException。要统一捕获并处理它，需通过全局异常处理器实现。
定义全局异常处理器
创建一个被 @ControllerAdvice 注解的类，用 @ExceptionHandler 捕获该异常：
@ControllerAdvice
public class GlobalExceptionHandler {
@ExceptionHandler(MethodArgumentNotValidException.class)
public ResponseEntity<map string>> handleValidationExceptions(
MethodArgumentNotValidException ex) {
Map<string string> errors = new HashMap();
ex.getBindingResult().getFieldErrors().forEach(error ->
errors.put(error.getField(), error.getDefaultMessage())
);
return ResponseEntity.badRequest().body(errors);
}
}</string></map>
确保实体类有正确的校验注解
只有添加了 JSR-303 校验注解（如 @NotBlank、@Min、@Email 等），且参数上标注了 @Valid，才会触发该异常：
public class UserDTO {
@NotBlank(message = "用户名不能为空")
private String username;
@Email(message = "邮箱格式不正确")
private String email;
}
@PostMapping("/users")
public String createUser(@Valid @RequestBody UserDTO user) {
return "success";
}
注意常见遗漏点
以下情况会导致异常不被捕获或校验不生效：
- 忘记在参数前加
@Valid（@RequestBody不会自动校验） - 使用了
@Validated但未指定分组，而实体注解用了groups属性 - 异常处理器类没被 Spring 扫描到（确认包路径在主启动类扫描范围内，或显式加
@ComponentScan） - 自定义了
WebMvcConfigurer且覆盖了默认的Validator，但未正确配置LocalValidatorFactoryBean
进阶：返回结构化错误响应
推荐封装标准错误响应体，提升 API 可读性：
public class ValidationErrorResponse {
private int status = HttpStatus.BAD_REQUEST.value();
private String message = "参数校验失败";
private List<fielderror> details = new ArrayList();
// getter / setter...
}
// 在异常处理器中：
@ExceptionHandler(MethodArgumentNotValidException.class)
public ResponseEntity<validationerrorresponse> handleValidationExceptions(
MethodArgumentNotValidException ex) {
ValidationErrorResponse response = new ValidationErrorResponse();
ex.getBindingResult().getFieldErrors().forEach(error ->
response.getDetails().add(new FieldError(error.getField(), error.getDefaultMessage()))
);
return ResponseEntity.badRequest().body(response);
}</validationerrorresponse></fielderror>
Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
