Hibernate Validator参数错误时无日志无异常且返回空400响应问题

我有一个使用Hibernate Validator校验参数的Spring REST控制器，其REST方法的入参是带有@Valid注解的XFilterRequest类，该类包含一个带@Valid注解的成员：

@Valid
protected XFilter filter;

XFilter类有一个校验成员：

@Size(max = 255, message = "searchString size must be at most 255")
private String searchString; 

当传入长度超过255的searchString时，接口返回400状态码（符合预期）但HTTP响应内容为空。我已在application.yml中配置：

server.error.include-binding-errors: always

但无任何效果。查看日志可见Hibernate Validator确实在校验该超长参数，但日志中无异常输出，也未向调用者返回校验提示消息。调试发现转换为XFilterRequest时存在绑定异常，但@Size约束的提示消息未传递到响应中，添加server.error.include-message: always配置后仍返回空400响应，怀疑Spring Boot/Spring Web屏蔽了部分异常消息。

1. 自定义全局绑定异常处理器 #

Spring Boot默认异常处理可能未正确处理嵌套对象的校验错误，可自定义@ControllerAdvice捕获MethodArgumentNotValidException，手动提取校验信息返回：

import org.springframework.http.HttpStatus;
import org.springframework.http.ResponseEntity;
import org.springframework.validation.FieldError;
import org.springframework.web.bind.MethodArgumentNotValidException;
import org.springframework.web.bind.annotation.ControllerAdvice;
import org.springframework.web.bind.annotation.ExceptionHandler;

import java.util.HashMap;
import java.util.Map;

@ControllerAdvice
public class GlobalValidationExceptionHandler {

    @ExceptionHandler(MethodArgumentNotValidException.class)
    public ResponseEntity<Map<String, String>> handleValidationExceptions(MethodArgumentNotValidException ex) {
        Map<String, String> errors = new HashMap<>();
        ex.getBindingResult().getAllErrors().forEach((error) -> {
            String fieldName = ((FieldError) error).getField();
            String errorMessage = error.getDefaultMessage();
            errors.put(fieldName, errorMessage);
        });
        return new ResponseEntity<>(errors, HttpStatus.BAD_REQUEST);
    }
}

该处理器会捕获参数校验失败异常，提取所有字段（包括嵌套对象如filter.searchString）的错误信息，以JSON格式返回给调用者。

2. 检查Spring Boot版本配置差异 #

不同版本Spring Boot的错误配置属性有差异：

• Spring Boot 2.3+ 可使用server.error.include-binding-errors: always和server.error.include-message: always，需确保配置文件拼写无错误；
• 若为更早版本，需对应使用旧属性，同时排查是否存在spring.mvc.throw-exception-if-no-handler-found=true这类可能拦截异常的配置。

3. 确认嵌套校验注解使用正确 #

• 确保XFilterRequest中的filter成员已添加@Valid，且XFilter类的校验注解导入正确（Spring Boot 2.x用javax.validation.constraints.Size，3.x用jakarta.validation.constraints.Size）；
• 确认XFilter作为请求POJO可正常实例化，无需额外@Component注解，但需保证能被Spring正确解析。

4. 排查其他异常处理器的覆盖问题 #

检查项目中是否存在其他@ControllerAdvice或@ExceptionHandler，这类组件可能覆盖Spring Boot默认的校验异常处理逻辑，需调整优先级或合并处理逻辑。

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