自定义Bean Validator无法自动注入Service的问题排查

问题分析 #

核心问题是自定义校验器UniqueCarBrandNameValidator中的CarBrandService始终为null，原因是默认的JSR-380校验工厂未使用Spring容器创建校验器实例，导致Spring依赖注入机制失效。改用构造注入后报错，则是因为JSR-380规范要求校验器具备无参构造，默认工厂会尝试通过反射调用无参构造创建实例，与Spring构造注入逻辑冲突。

解决方案 #

1. 修正Spring Validator配置 #

修改AppConfig类，让LocalValidatorFactoryBean关联Spring上下文，确保校验器由Spring容器管理：

import org.springframework.context.ApplicationContext;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
import org.springframework.validation.Validator;
import org.springframework.validation.beanvalidation.LocalValidatorFactoryBean;
import org.springframework.validation.beanvalidation.MethodValidationPostProcessor;

@Configuration
public class AppConfig {

    @Bean
    public LocalValidatorFactoryBean validator(ApplicationContext applicationContext) {
        LocalValidatorFactoryBean factoryBean = new LocalValidatorFactoryBean();
        // 关联Spring上下文，让校验器由Spring容器实例化
        factoryBean.setApplicationContext(applicationContext);
        return factoryBean;
    }

    @Bean
    public MethodValidationPostProcessor validationPostProcessor(Validator validator) {
        MethodValidationPostProcessor postProcessor = new MethodValidationPostProcessor();
        // 指定使用Spring管理的Validator，确保方法级校验也能使用注入的依赖
        postProcessor.setValidator(validator);
        return postProcessor;
    }
}

2. 调整校验器的注入方式 #

使用构造注入（Spring 4.3+可省略@Autowired），同时保留@Component注解确保Spring扫描到该类：

import icodeit.carfleetmanager.service.CarBrandService;
import jakarta.validation.ConstraintValidator;
import jakarta.validation.ConstraintValidatorContext;
import org.springframework.stereotype.Component;

@Component
public class UniqueCarBrandNameValidator implements ConstraintValidator<UniqueCarBrandName, String> {

    private final CarBrandService carBrandService;

    // Spring 4.3+ 单个构造函数可省略@Autowired
    public UniqueCarBrandNameValidator(CarBrandService carBrandService) {
        this.carBrandService = carBrandService;
    }

    @Override
    public boolean isValid(String name, ConstraintValidatorContext constraintValidatorContext) {
        return carBrandService.fetchOneByName(name).isEmpty();
    }
}

3. 额外检查项 #

• 确认CarBrandService类标注了@Service或其他Spring Bean注解（你提到控制器可正常注入，此步骤大概率已完成）。
• 确认Spring组件扫描路径包含校验器所在包（默认扫描启动类所在包及其子包）。
• 在Controller或Service层使用校验时，使用Spring的@Valid或@Validated注解，而非手动调用JSR-380原生的Validator接口。

原理说明 #

• 配置LocalValidatorFactoryBean并关联Spring上下文后，Spring会接管校验器的实例化过程，所有标注@Component的校验器都会被纳入Spring容器管理，依赖注入自然生效。
• 给MethodValidationPostProcessor指定Spring管理的Validator，可确保方法级校验（如Service层的@Validated）也能使用带有依赖注入的校验器。

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