Hibernate Validator验证失效求助：JSR303@NotEmpty注解无效果

嘿，我来帮你一步步排查这个校验失效的问题！结合你的场景，我整理了几个最常见的原因和对应的解决办法：

1. 先确认依赖是否正确引入 #

如果是Spring Boot项目：

• Spring Boot 2.x需要单独引入spring-boot-starter-validation（2.3版本之后web starter不再默认包含校验依赖）
• Spring Boot 3+的校验依赖已整合在web starter中，但要注意注解包是jakarta.validation.constraints而非旧的javax

Maven依赖（Spring Boot 2.x）：

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

如果是普通Java项目，需要同时引入API规范和Hibernate Validator实现：

<dependency>
    <groupId>javax.validation</groupId>
    <artifactId>validation-api</artifactId>
    <version>2.0.1.Final</version>
</dependency>
<dependency>
    <groupId>org.hibernate.validator</groupId>
    <artifactId>hibernate-validator</artifactId>
    <version>6.1.7.Final</version>
</dependency>

2. 检查注解的包和适用场景 #

你用的@NotEmpty要注意两个关键细节：

• 包路径是否正确：Spring Boot 3+必须用jakarta.validation.constraints.NotEmpty，Spring Boot 2.x用javax.validation.constraints.NotEmpty，别搞混了！
• 适用字段类型：@NotEmpty仅支持字符串、集合、数组这类有长度/大小属性的类型。如果是int、long这类基本类型，要改用@NotNull或@Min这类适配的注解。

比如你的User实体中字符串字段的正确写法：

@Column(nullable = false)
@NotEmpty(message = "用户名不能为空")
private String username;

3. 确保校验逻辑被正确触发 #

光在实体上加注解不会自动生效，必须主动触发校验：

场景1：Controller层接收请求时校验 #

在请求参数前添加@Valid或@Validated注解，Spring会自动触发校验，同时用BindingResult获取错误信息：

@PostMapping("/users")
public ResponseEntity<?> createUser(@Valid @RequestBody User user, BindingResult bindingResult) {
    // 处理校验错误
    if (bindingResult.hasErrors()) {
        List<String> errorMessages = bindingResult.getAllErrors()
                .stream()
                .map(error -> error.getDefaultMessage())
                .collect(Collectors.toList());
        return ResponseEntity.badRequest().body(errorMessages);
    }
    // 执行后续业务逻辑
    userService.save(user);
    return ResponseEntity.ok("用户创建成功");
}

场景2：Service层手动校验 #

如果需要在Service层做校验，要注入Validator手动调用校验方法：

@Service
public class UserService {
    private final Validator validator;

    // 构造注入Validator
    public UserService(Validator validator) {
        this.validator = validator;
    }

    public void saveUser(User user) {
        Set<ConstraintViolation<User>> violations = validator.validate(user);
        if (!violations.isEmpty()) {
            // 抛出校验异常或自定义错误处理
            throw new ConstraintViolationException(violations);
        }
        // 执行保存逻辑
    }
}

4. 检查实体类是否有getter方法 #

Hibernate Validator是通过字段的getter方法获取值进行校验的，如果你的实体类字段没有对应getter，校验会直接失效！比如username字段必须有：

public String getUsername() {
    return username;
}

5. 排查配置问题（非Spring Boot项目） #

如果是普通Spring项目，需要在配置类中手动配置Validator的Bean：

@Configuration
public class ValidatorConfig {
    @Bean
    public Validator validator() {
        return Validation.buildDefaultValidatorFactory().getValidator();
    }
}

按照上面的步骤逐一排查，应该就能解决你的校验不生效问题啦！

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