多模块项目中使用javax.validation.NotBlank遇验证器缺失异常求助

这个问题我之前帮好几个开发者排查过，本质是Bean Validation的API和具体实现没匹配到位，导致JVM找不到NotBlank对应的验证器。咱们一步步来解决：

1. 先确认依赖是否正确配置 #

javax.validation只是一套规范API，必须搭配具体的实现（比如Hibernate Validator）才能生效。如果你的项目里只引入了validation-api，却没加Hibernate Validator的核心依赖，就会出现这个异常。

Maven依赖示例（版本要匹配！） #

<!-- Bean Validation API -->
<dependency>
    <groupId>javax.validation</groupId>
    <artifactId>validation-api</artifactId>
    <version>2.0.1.Final</version>
</dependency>
<!-- Hibernate Validator 实现（和API版本对应：2.x API配6.x实现） -->
<dependency>
    <groupId>org.hibernate.validator</groupId>
    <artifactId>hibernate-validator</artifactId>
    <version>6.1.5.Final</version>
</dependency>
<!-- 可选：注解处理器，编译期检查验证注解 -->
<dependency>
    <groupId>org.hibernate.validator</groupId>
    <artifactId>hibernate-validator-annotation-processor</artifactId>
    <version>6.1.5.Final</version>
    <scope>provided</scope>
</dependency>

版本对应规则：validation-api 2.x → hibernate-validator 6.x；validation-api 3.x → hibernate-validator 7.x，别搞混了！

2. 检查Vaadin的验证集成是否正确 #

Vaadin默认会自动使用Bean Validation，但如果你的项目上下文里没有正确初始化ValidatorFactory，可能导致Vaadin找不到验证器。可以手动初始化Validator来验证：

import javax.validation.Validation;
import javax.validation.Validator;
import javax.validation.ValidatorFactory;
import javax.validation.ConstraintViolation;
import java.util.Set;

// 在需要验证的地方获取Validator实例
ValidatorFactory factory = Validation.buildDefaultValidatorFactory();
Validator validator = factory.getValidator();

// 验证你的域对象
MyDomainObject obj = new MyDomainObject();
Set<ConstraintViolation<MyDomainObject>> violations = validator.validate(obj);

// 处理验证结果
if (!violations.isEmpty()) {
    for (ConstraintViolation<MyDomainObject> violation : violations) {
        // 输出错误信息或者绑定到Vaadin组件
        System.out.println(violation.getMessage());
    }
}

3. 确认域对象的字段类型 #

虽然异常提示的是java.lang.String，但还是要检查你的字段是不是真的是标准String类型——比如有没有不小心用了自定义的String子类，或者CharSequence的其他实现？@NotBlank只支持String类型，其他类型会触发这个异常。

示例正确的域对象：

import javax.validation.constraints.NotBlank;

public class MyDomainObject {
    @NotBlank(message = "名称不能为空")
    private String name; // 必须是java.lang.String

    // getter和setter
    public String getName() {
        return name;
    }

    public void setName(String name) {
        this.name = name;
    }
}

4. 排查依赖冲突 #

有时候项目里会引入多个版本的Bean Validation相关依赖，导致冲突。可以用Maven命令查看依赖树，找出冲突的版本：

mvn dependency:tree -Dincludes=javax.validation,org.hibernate.validator

如果发现有重复或者版本不兼容的依赖，在pom.xml里用exclusions排除掉旧版本的依赖，统一使用兼容的版本。

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