MethodArgumentNotValidException处理被DefaultErrorAttributes覆盖，需自定义验证响应体

我太懂这种挫败感了！之前做参数校验自定义响应的时候，也踩过这个DefaultErrorAttributes的坑。其实核心原因是Spring Boot的默认错误处理链中，DefaultErrorAttributes会在你的ExceptionHandler之后介入，覆盖掉你构建的响应体。下面给你几个靠谱的解决办法：

方法一：禁用默认的ErrorMvcAutoConfiguration #

直接关掉Spring Boot自带的错误处理自动配置，彻底避免DefaultErrorAttributes捣乱。只需要在你的启动类上加上：

@SpringBootApplication(exclude = ErrorMvcAutoConfiguration.class)
public class YourApplication {
    public static void main(String[] args) {
        SpringApplication.run(YourApplication.class, args);
    }
}

这个方法简单粗暴，但要注意：禁用后所有默认的错误页面/响应都失效了，你需要在ErrorHandler里处理所有你关心的异常类型。

方法二：自定义ErrorAttributes替代DefaultErrorAttributes #

如果你不想完全禁用默认配置，可以自己实现ErrorAttributes接口，替换掉默认的Bean。这样既保留Spring Boot的错误处理框架，又能按照你的需求生成响应体：

@Component
public class CustomErrorAttributes extends DefaultErrorAttributes {
    private final MessageSource messageSource;

    public CustomErrorAttributes(MessageSource messageSource) {
        this.messageSource = messageSource;
    }

    @Override
    public Map<String, Object> getErrorAttributes(WebRequest webRequest, ErrorAttributeOptions options) {
        // 先获取默认的错误属性
        Map<String, Object> errorAttributes = super.getErrorAttributes(webRequest, options);
        
        // 从请求中获取MethodArgumentNotValidException异常
        Throwable throwable = getError(webRequest);
        if (throwable instanceof MethodArgumentNotValidException) {
            MethodArgumentNotValidException ex = (MethodArgumentNotValidException) throwable;
            List<String> errors = ex.getBindingResult().getFieldErrors().stream()
                    .map(fieldError -> messageSource.getMessage(fieldError, LocaleContextHolder.getLocale()))
                    .collect(Collectors.toList());
            
            // 替换成你的自定义响应结构
            errorAttributes.clear();
            errorAttributes.put("code", "VALIDATION_FAILED");
            errorAttributes.put("message", "参数校验失败");
            errorAttributes.put("details", errors);
        }
        
        return errorAttributes;
    }
}

然后你的ErrorHandler可以简化，只需要确保异常被正确抛出：

@RestControllerAdvice
@Slf4j
@RequiredArgsConstructor
public class ErrorHandler extends ResponseEntityExceptionHandler {
    private final MessageSource messageSource;

    @Override
    protected ResponseEntity<Object> handleMethodArgumentNotValid(MethodArgumentNotValidException ex, HttpHeaders headers, HttpStatus status, WebRequest request) {
        // 这里无需构建完整响应，CustomErrorAttributes会统一处理
        return super.handleMethodArgumentNotValid(ex, headers, status, request);
    }
}

方法三：在ExceptionHandler中直接跳过DefaultErrorAttributes处理 #

还有一种轻量方式，在你的handleMethodArgumentNotValid方法里，构建响应体后设置特定请求属性，告诉DefaultErrorAttributes不要介入：

@RestControllerAdvice
@Slf4j
@RequiredArgsConstructor
public class ErrorHandler extends ResponseEntityExceptionHandler {
    private final MessageSource messageSource;

    @Override
    protected ResponseEntity<Object> handleMethodArgumentNotValid(MethodArgumentNotValidException ex, HttpHeaders headers, HttpStatus status, WebRequest request) {
        // 构建你的自定义响应体
        Map<String, Object> responseBody = new HashMap<>();
        responseBody.put("timestamp", LocalDateTime.now());
        responseBody.put("status", status.value());
        responseBody.put("errors", ex.getBindingResult().getFieldErrors().stream()
                .map(fieldError -> messageSource.getMessage(fieldError, LocaleContextHolder.getLocale()))
                .collect(Collectors.toList()));

        // 关键：清空异常属性，让DefaultErrorAttributes忽略此响应
        request.setAttribute("javax.servlet.error.exception", null, WebRequest.SCOPE_REQUEST);

        return new ResponseEntity<>(responseBody, headers, status);
    }
}

这个方法的原理是：DefaultErrorAttributes会检查请求中是否存在javax.servlet.error.exception属性，若不存在就不会覆盖你的自定义响应。

注意事项 #

• 不要在重写的方法中调用super.handleMethodArgumentNotValid(...)，除非你想让默认逻辑介入，否则会覆盖你的自定义响应。
• 确保你的@RestControllerAdvice被Spring正确扫描到，必要时可以加上basePackages指定扫描范围。

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