Spring自定义ResponseEntityExceptionHandler如何返回ResponseStatusException同款响应体

要让MethodArgumentNotValidException的响应和ResponseStatusException完全一致（状态码400、响应体结构匹配），你需要避免在ResponseEntityExceptionHandler的处理方法中抛出异常，而是直接利用Spring的DefaultErrorAttributes构建标准错误响应体，具体实现如下：

核心思路 #

ResponseEntityExceptionHandler的处理方法需要直接返回ResponseEntity<Object>，而不是抛出异常。Spring的DefaultErrorAttributes是框架默认生成ResponseStatusException响应体的组件，复用它可以确保响应结构完全对齐，包括timestamp、status、error、message、path这些标准字段。

代码实现 #

@ControllerAdvice
public class CustomExceptionHandlers extends ResponseEntityExceptionHandler {

    private final DefaultErrorAttributes errorAttributes;

    // 注入Spring默认的错误属性生成组件
    public CustomExceptionHandlers(DefaultErrorAttributes errorAttributes) {
        this.errorAttributes = errorAttributes;
    }

    @Override
    protected ResponseEntity<Object> handleMethodArgumentNotValid(MethodArgumentNotValidException ex,
                                                                  HttpHeaders headers,
                                                                  HttpStatus status,
                                                                  WebRequest request) {
        // 提取第一个字段的错误信息（保持你原有逻辑）
        FieldError err = ex.getBindingResult().getFieldErrors().get(0);
        String errorMessage = "Unknown error";
        if (err != null) {
            errorMessage = err.getField() + ": " + err.getDefaultMessage();
        }

        // 获取与ResponseStatusException一致的标准错误属性
        Map<String, Object> errorResponse = errorAttributes.getErrorAttributes(
                request,
                ErrorAttributeOptions.of(ErrorAttributeOptions.Include.MESSAGE)
        );

        // 覆盖错误消息与状态码，确保和目标格式一致
        errorResponse.put("message", errorMessage);
        errorResponse.put("status", HttpStatus.BAD_REQUEST.value());
        errorResponse.put("error", HttpStatus.BAD_REQUEST.getReasonPhrase());

        // 返回400状态码的响应
        return new ResponseEntity<>(errorResponse, headers, HttpStatus.BAD_REQUEST);
    }
}

为什么原代码无效？ #

你之前的代码在handleMethodArgumentNotValid中抛出ResponseStatusException，这违背了ResponseEntityExceptionHandler的设计意图——这个类的处理方法就是用来直接生成异常响应的，抛出的异常会被Spring的全局异常处理器二次处理，导致响应结构无法受控，最终达不到和ResponseStatusException一致的效果。

扩展说明 #

如果需要返回所有字段的错误信息而非仅第一个，只需修改错误消息的提取逻辑，例如：

List<String> errorMessages = ex.getBindingResult().getFieldErrors().stream()
        .map(fieldError -> fieldError.getField() + ": " + fieldError.getDefaultMessage())
        .collect(Collectors.toList());
errorResponse.put("message", errorMessages);

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