无注解Hibernate类级校验 程序式定义自定义校验器未被调用排查

你当前代码的核心疏漏点 #

• 最关键的逻辑缺失：仅完成了注解与校验器的绑定，没有把约束实际挂载到目标Model的对应校验位置
  你代码中调用的constraintDefinition(自定义注解.class).validatedBy(自定义校验器.class)，仅负责建立“某一个自定义注解对应哪一个校验实现类”的全局关联，和“哪个类的哪个字段、哪个类层级需要应用这个校验规则”完全无关。框架根本不知道你要对ModelClass执行这个自定义校验，自然不会触发对应校验器。
• ValidatorFactory的生命周期使用完全错误
  你是在已经初始化完成的this.validatorFactory实例上，半路创建ConstraintMapping、调用addMapping后再重新build工厂。这种写法下，你新追加的映射根本不会被纳入已经生成好的约束元数据解析链路。Hibernate Validator的设计要求，所有程序式定义的约束映射必须在ValidatorFactory初始化构建阶段作为配置项传入，才能被框架识别加载。
• 容易踩的关联坑：因为你的校验逻辑需要依赖Repository层的数据库查询能力，不能让Hibernate Validator自己通过反射new校验器实例，否则校验器里注入的Repository字段会是空值，就算约束挂载成功也无法正常执行数据库查询。

正确的实现逻辑与代码示例 #

实现步骤 #

1. 先全局建立自定义注解与对应校验器的绑定关系
2. 针对目标Model类，明确指定要应用该约束的位置（类层级/具体字段层级/方法层级）
3. 在应用启动初始化ValidatorFactory的阶段，把完整的约束映射传入配置，构建全局单例的ValidatorFactory，不要每次校验都重复构建工厂实例
4. 配置自定义的ConstraintValidatorFactory，让Spring等容器负责创建校验器实例，保证校验器可以正常注入Repository依赖

修正后的核心代码 #

// 1. 构建完整的约束映射
ConstraintMapping constraintMapping = new ConstraintMapping();
// 建立自定义注解与校验器的全局绑定
constraintMapping
    .constraintDefinition(ExistsInDatabase.class)
    .validatedBy(DbExistsConstraintValidator.class);
// 给目标Model配置具体的校验规则
constraintMapping
    .type(ModelClass.class)
    .ignoreAnnotations(true) // 因为Model本身没有写注解，开这个开关不会影响程序式添加的约束
    // 字段级校验示例：给email字段加“数据库已存在该值”的校验
    .field("email")
    .constraint(
        new ConstraintDef<>(ModelClass.class, ExistsInDatabase.class)
            .param("targetField", "email")
            .param("targetTable", "user")
    )
    // 类级校验示例：如果需要整个对象维度的校验，在这里配置
    ._class()
    .constraint(
        new ConstraintDef<>(ModelClass.class, ExistsInDatabase.class)
            .param("targetField", "id")
            .param("targetTable", "user")
    );
// 2. 初始化ValidatorFactory时传入映射配置
HibernateValidatorConfiguration config = Validation
    .byProvider(HibernateValidator.class)
    .configure();
// 把自定义的约束校验器工厂传进去，保证可以注入容器Bean
config.constraintValidatorFactory(new SpringBeanInjectingConstraintValidatorFactory());
// 传入程序式定义的映射
config.addMapping(constraintMapping);
// 构建单例工厂，全局复用
ValidatorFactory validatorFactory = config.buildValidatorFactory();
Validator validator = validatorFactory.getValidator();

补充注意点 #

• .ignoreAnnotations(true)仅会关闭对类上现存注解的扫描识别，不会覆盖你通过程序式代码添加的约束规则，这个配置本身没有问题
• 不要在每次执行校验操作时重新构建ValidatorFactory，该操作会重复加载所有约束元数据，性能开销极大，正确的做法是在应用启动阶段完成所有初始化后，单例复用工厂实例
• 如果你的项目已经集成了Spring Validation，不需要手动构建ValidatorFactory，只需要把上述ConstraintMapping配置注册到Spring的ValidatorBean中即可，不需要改变原有的组件扫描配置逻辑

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