Spring Boot 3.2.2中@NotEmpty输入验证器失效问题求助

以下是针对问题的排查和解决步骤：

1. 修正依赖版本，避免版本冲突 #

你当前使用的spring-boot-starter-validation版本是3.1.0，与Spring Boot主版本3.2.2不一致，版本不兼容可能导致验证组件失效。建议移除硬编码的版本号，依赖Spring Boot父项目的版本管理：

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

若未使用父项目，需确保依赖版本与Spring Boot版本完全一致（即3.2.2）。

2. 简化控制器注解配置 #

针对@RequestBody参数的验证，无需同时在控制器类加@Validated和参数加@Valid，二选一即可。推荐保留参数上的@Valid：

@RestController
@RequestMapping("/api/posts")
public class PostController {
    private final PostService postService;

    public PostController(PostService postService) {
        this.postService = postService;
    }

    @PostMapping
    public ResponseEntity<PostDto> createPost (@Valid @RequestBody PostDto postDto) {       
        return new ResponseEntity<>(postService.createPost(postDto), HttpStatus.CREATED);
    }
}

3. 确认注解与验证场景匹配 #

• @NotEmpty仅验证字符串非null且长度大于0，若传入全空格字符串（如" "），该注解不会触发验证，此时需改用@NotBlank（导入jakarta.validation.constraints.NotBlank）。
• 若需验证字段不能为null且内容非空，可组合@NotNull和@NotEmpty，或直接使用@NotBlank（针对字符串场景）。

4. 添加全局异常处理器捕获验证错误 #

若验证已触发但未看到错误响应，可能是未捕获MethodArgumentNotValidException异常。添加全局异常处理器返回明确的错误信息：

@RestControllerAdvice
public class GlobalExceptionHandler {

    @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);
    }
}

5. 排查自动配置禁用情况 #

检查application.properties或application.yml中是否存在禁用验证自动配置的配置，确保没有如下内容：

# 需移除类似禁用配置
spring.autoconfigure.exclude=org.springframework.boot.autoconfigure.validation.ValidationAutoConfiguration

6. 验证测试请求的触发条件 #

测试时需确保请求体满足验证触发条件：

• 传入"title": ""（空字符串）
• 若需验证字段不能为null，需配合@NotNull注解，此时不传title字段或传入"title": null会触发验证

若以上步骤无效，可尝试清理Maven/Gradle缓存后重新构建项目，排除依赖缓存问题。

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