如何在Spring Boot 3.5的400验证响应中保留原有JSON错误结构？

方案1：自定义ErrorAttributes替换默认实现 #

虽然DefaultErrorAttributes多数方法是私有，但可以直接继承它，重写getErrorAttributes核心方法，手动处理错误结构——把嵌套的cause字段里的内容平铺回顶层，再移除cause字段，就能恢复原有JSON路径。

代码示例：

@Component
public class LegacyErrorAttributes extends DefaultErrorAttributes {

    @Override
    public Map<String, Object> getErrorAttributes(WebRequest webRequest, ErrorAttributeOptions options) {
        Map<String, Object> errorAttributes = super.getErrorAttributes(webRequest, options);
        
        // 检查是否存在嵌套的cause结构
        if (errorAttributes.containsKey("cause")) {
            @SuppressWarnings("unchecked")
            Map<String, Object> cause = (Map<String, Object>) errorAttributes.get("cause");
            // 将cause中的字段合并到顶层
            errorAttributes.putAll(cause);
            // 移除嵌套的cause字段
            errorAttributes.remove("cause");
        }
        
        return errorAttributes;
    }
}

这个类会自动替换Spring Boot默认的ErrorAttributes，无需额外配置。

方案2：用ControllerAdvice全局接管BindException处理 #

直接绕过DefaultErrorAttributes的处理逻辑，在全局异常处理器中捕获BindException，完全按照原有格式构造响应体。

代码示例：

@RestControllerAdvice
public class LegacyValidationExceptionHandler {

    @ExceptionHandler(BindException.class)
    @ResponseStatus(HttpStatus.BAD_REQUEST)
    public Map<String, Object> handleBindException(BindException ex) {
        Map<String, Object> errorResponse = new HashMap<>();
        errorResponse.put("timestamp", LocalDateTime.now());
        errorResponse.put("status", HttpStatus.BAD_REQUEST.value());
        errorResponse.put("error", HttpStatus.BAD_REQUEST.getReasonPhrase());
        
        // 按原有格式生成字段错误列表
        List<Map<String, Object>> fieldErrors = ex.getBindingResult().getFieldErrors().stream()
                .map(error -> {
                    Map<String, Object> fieldError = new HashMap<>();
                    fieldError.put("field", error.getField());
                    fieldError.put("message", error.getDefaultMessage());
                    fieldError.put("rejectedValue", error.getRejectedValue());
                    return fieldError;
                })
                .collect(Collectors.toList());
        
        errorResponse.put("errors", fieldErrors);
        return errorResponse;
    }
}

这种方式完全自主控制响应结构，不受Spring Boot内部错误包装逻辑的影响。

方案3：检查是否有配置项可关闭错误包装 #

先查Spring Boot 3.5.3的官方文档或本次提交的说明，看是否新增了类似server.error.wrap-binding-errors=false的配置开关。如果有，直接在application.properties或application.yml里配置即可，这是最省心的方案。

内容的提问来源于stack exchange，提问作者E-Riz