Spring Boot 3.2.3请求体验证失效，求排查问题原因

以下是针对你遇到的验证未触发、接口返回200且控制台输出null问题的具体排查和解决步骤：

1. 检查请求体与实体类的结构匹配度 #

你发送的请求体如{"test": {"text": null}}，如果Controller直接接收@RequestBody Test test，但Test类本身没有test字段，会导致Spring无法完成参数绑定，最终test对象为null——此时@Valid不会触发任何验证（因为验证对象不存在），接口自然返回200，控制台输出null。

解决方式：

• 要么调整请求体为{"text": null}，与Test类结构对应；
• 要么创建外层实体类包裹Test对象，同时给嵌套字段加@Valid触发内部验证：

public class TestRequest {
    @Valid
    @NotNull(message = "test对象不能为空")
    private Test test;
    // 生成getter/setter
}

Controller改为接收：

@PostMapping("/test")
public ResponseEntity<String> test(@RequestBody @Valid TestRequest request) {
    // 业务逻辑
}

2. 嵌套对象必须添加@Valid注解 #

如果Test类内部包含其他实体类字段（比如你请求体中的test是嵌套对象），必须在该字段上添加@Valid，否则嵌套对象的@NotNull等注解不会生效：

public class Test {
    @Valid
    @NotNull(message = "子对象不能为空")
    private SubTest subTest;
    // getter/setter
}

public class SubTest {
    @NotNull(message = "text字段不能为空")
    private String text;
    // getter/setter
}

3. 确保Controller参数正确使用验证注解 #

在Spring Boot 3.x中，必须在@RequestBody参数前添加@Valid或@Validated注解，否则不会触发验证逻辑：

@PostMapping("/test")
public ResponseEntity<String> test(@RequestBody @Valid Test test) {
    // 业务逻辑
}

注：@Validated支持分组验证，@Valid是JSR-380标准注解，二者均可触发基础验证。

4. 检查实体类的注解与访问方法 #

• 确保@NotNull等注解直接加在需要验证的字段上，且实体类有对应的getter/setter方法（Spring需要通过这些方法访问字段）；
• 如果使用Lombok，确认@Data/@Getter/@Setter等注解已正确添加，没有遗漏导致字段无法被Spring访问。

5. 验证异常处理是否被覆盖 #

Spring Boot默认会在验证失败时抛出MethodArgumentNotValidException，并返回400 Bad Request及错误信息。如果你自定义了全局异常处理器，需确认是否错误捕获该异常并返回200，导致验证失效的假象。

正确的异常处理示例：

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

6. 确认依赖引入正确 #

再次检查spring-boot-starter-validation依赖是否正确引入：

• Maven：

<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-validation</artifactId>
</dependency>

• Gradle：

implementation 'org.springframework.boot:spring-boot-starter-validation'

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