如何处理MethodArgumentNotValidException？全局异常处理器失效问题

我用@ControllerAdvice实现了全局异常处理器，能正常处理ResourceNotFoundException这类自定义异常，但就是处理不了校验器抛出的MethodArgumentNotValidException——现在校验不通过时只会返回状态码400的空响应。我还试过不继承ResponseEntityExceptionHandler，直接用@ExceptionHandler标注处理这个异常，但响应体被忽略，返回的是Spring默认的错误信息，而且没有任何报错提示。

全局异常处理器代码 #

@ControllerAdvice
public class RestResponseEntityExceptionHandler extends ResponseEntityExceptionHandler {
    @ExceptionHandler(value = {ResourceNotFoundException.class, EntityNotFoundException.class})
    protected ResponseEntity<Object> handleNotFound(RuntimeException ex, WebRequest request) {
        APIException apiException = new APIException(HttpStatus.NOT_FOUND, ex.getMessage(), request);
        return handleExceptionInternal(ex, apiException, new HttpHeaders(), apiException.getStatus(), request);
    }

    @Override
    protected ResponseEntity<Object> handleMethodArgumentNotValid(MethodArgumentNotValidException ex, HttpHeaders headers, HttpStatus status, WebRequest request) {
        APIException apiException = new APIException(HttpStatus.BAD_REQUEST, ex.getMessage(), request);
        return handleExceptionInternal(ex, apiException, new HttpHeaders(), apiException.getStatus(), request);
    }
}

校验DTO类 #

public class ClassQuery {
    @Min(1)
    private Integer minYear;
    @Min(1)
    private Integer year;
    @Min(1)
    private Integer maxYear;
    private String name;
    private String profile;

    // 省略getter/setter
}

REST控制器代码 #

@GetMapping
public Page<Class> getClasses(@Valid ClassQuery classQuery, Pageable pageable) {
    return classService.getClasses(classQuery, pageable);
}

API异常封装类 #

public class APIException {
    private Date timestamp;
    private HttpStatus status;
    private String message;
    private String path;

    public APIException(HttpStatus status, String message, WebRequest request) {
        this();
        this.status = status;
        this.message = message;
        this.path = getRequestURI(request);
    }

    // 省略getter/setter和getRequestURI方法
}

问题分析&解决方案 #

核心问题点 #

1. 你重写handleMethodArgumentNotValid时，直接使用ex.getMessage()获取的信息并不包含具体的校验错误，而且新建空HttpHeaders可能导致响应体序列化异常；
2. 若直接用@ExceptionHandler处理失败，大概率是没有正确提取校验错误信息，或者APIException的序列化存在问题。

方案1：修复继承ResponseEntityExceptionHandler的实现 #

从MethodArgumentNotValidException的BindingResult中提取真实校验错误，同时复用传入的HttpHeaders避免丢失关键信息：

@Override
protected ResponseEntity<Object> handleMethodArgumentNotValid(MethodArgumentNotValidException ex, HttpHeaders headers, HttpStatus status, WebRequest request) {
    // 提取所有字段的校验错误信息
    List<String> errorDetails = ex.getBindingResult()
            .getFieldErrors()
            .stream()
            .map(error -> String.format("%s: %s", error.getField(), error.getDefaultMessage()))
            .collect(Collectors.toList());
    
    // 封装为友好的错误提示
    String errorMsg = String.join("; ", errorDetails);
    APIException apiException = new APIException(HttpStatus.BAD_REQUEST, errorMsg, request);
    
    // 复用传入的headers，而非新建空对象
    return handleExceptionInternal(ex, apiException, headers, apiException.getStatus(), request);
}

方案2：不继承ResponseEntityExceptionHandler，直接用@ExceptionHandler处理 #

如果之前直接处理失败，试试明确构造响应实体，确保错误信息被正确序列化：

@ControllerAdvice
public class RestResponseEntityExceptionHandler {
    @ExceptionHandler(value = {ResourceNotFoundException.class, EntityNotFoundException.class})
    protected ResponseEntity<Object> handleNotFound(RuntimeException ex, WebRequest request) {
        APIException apiException = new APIException(HttpStatus.NOT_FOUND, ex.getMessage(), request);
        return new ResponseEntity<>(apiException, apiException.getStatus());
    }

    @ExceptionHandler(MethodArgumentNotValidException.class)
    protected ResponseEntity<Object> handleMethodArgumentNotValid(MethodArgumentNotValidException ex, WebRequest request) {
        List<String> errorDetails = ex.getBindingResult()
                .getFieldErrors()
                .stream()
                .map(error -> String.format("%s: %s", error.getField(), error.getDefaultMessage()))
                .collect(Collectors.toList());
        String errorMsg = String.join("; ", errorDetails);
        APIException apiException = new APIException(HttpStatus.BAD_REQUEST, errorMsg, request);
        return new ResponseEntity<>(apiException, HttpStatus.BAD_REQUEST);
    }
}

额外检查项 #

• 确保APIException的无参构造中初始化了timestamp字段（比如this.timestamp = new Date();），否则序列化时可能因字段缺失导致响应为空；
• 确认项目已正确配置Jackson等消息转换器，保证APIException能被正常序列化为JSON；
• 检查@ControllerAdvice所在包是否在Spring Boot主应用类的扫描范围内。

内容的提问来源于stack exchange，提问作者Syzak