Spring Boot 3.1.X迁移后ConstraintValidator无参构造器报错问题

问题根源 #

Spring Boot 3.1.x依赖Hibernate Validator 8.x（适配Jakarta EE 9规范），而2.7.x版本搭配的是Hibernate Validator 6.x，两者在ConstraintValidator的实例化逻辑上存在核心差异：

• 2.7.x时代，Spring默认接管Validator的创建流程，支持通过构造器/@Autowired注入依赖（不需要无参构造）。
• 3.1.x中，Hibernate Validator默认使用自身工厂实例化Validator，强制要求无参构造；如果你的Validator依赖Spring容器中的Bean（比如Repository、Service），手动添加无参构造会导致依赖注入失败，进而引发验证逻辑失效、触发时机异常等连锁问题。

你遇到的验证延迟触发、主键冲突，本质是Validator依赖未被正确注入，导致验证逻辑没有在请求入口执行，业务代码先完成了数据插入，后续触发验证时已无法回滚；甚至因为验证失效，导致重复数据被插入。部分Validator无问题，大概率是这些Validator没有依赖Spring Bean，无参构造就能正常工作。

解决步骤 #

1. 让Spring接管Validator实例化 #

在application.properties或application.yml中添加配置，指定Hibernate Validator使用Spring的工厂类创建Validator：

# Spring Boot 3.x 适配Jakarta命名空间
jakarta.persistence.validation.factory=org.springframework.validation.beanvalidation.LocalValidatorFactoryBean

这个配置会让Hibernate Validator从Spring容器获取Validator实例，而非自行创建，这样你的Validator可以正常使用构造器注入或@Autowired，无需添加无参构造。

2. 确保Validator被Spring管理 #

给所有自定义ConstraintValidator添加@Component注解，让Spring扫描并管理这些Bean：

@Component
public class CustomerAddressValidator implements ConstraintValidator<ValidCustomerAddress, CustomerAddress> {

    private final CustomerRepository customerRepository;

    // 构造器注入依赖，无需无参构造
    public CustomerAddressValidator(CustomerRepository customerRepository) {
        this.customerRepository = customerRepository;
    }

    @Override
    public boolean isValid(CustomerAddress value, ConstraintValidatorContext context) {
        // 验证逻辑，依赖的Repository已正常注入
        return !customerRepository.existsByAddress(value.getAddress());
    }
}

3. 修复单元测试混乱问题 #

单元测试中要确保加载Spring上下文，或者手动配置LocalValidatorFactoryBean，避免使用Hibernate默认的Validator工厂：

• 用@SpringBootTest替代单纯的@Test，确保完整Spring上下文初始化，Validator依赖能正常注入。
• 如果是轻量测试，可手动注入LocalValidatorFactoryBean并传入测试用的依赖Mock：

@ExtendWith(SpringExtension.class)
public class CustomerAddressValidatorTest {

    private Validator validator;

    @MockBean
    private CustomerRepository customerRepository;

    @BeforeEach
    void setUp() {
        LocalValidatorFactoryBean factory = new LocalValidatorFactoryBean();
        factory.setValidationMessageSource(new ResourceBundleMessageSource());
        factory.afterPropertiesSet();
        validator = factory.getValidator();
    }

    // 测试逻辑
}

4. 排查特殊Validator的异常 #

针对部分仍有问题的Validator，检查：

• 是否依赖了请求作用域（@RequestScoped）或会话作用域的Bean，这类Bean在Validator实例化时可能无法正常获取。
• 是否在Validator中使用了非Spring管理的对象（比如手动new的实例），导致状态异常。

验证效果 #

配置完成后：

• 无需为Validator添加无参构造，依赖注入正常。
• 验证逻辑会在请求入口（比如带@Valid注解的Controller方法）触发，不会延迟到API调用末尾。
• 单元测试中Validator的行为与生产环境一致，不会出现混乱。

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