Spring无法识别@Qualifier？父子Job场景下测试Bean注入冲突

你遇到的核心问题是**@Qualifier注解的使用位置错误**，导致Spring无法正确识别要注入到JobLauncherTestUtils中的目标Job Bean。

为什么原来的代码不生效？ #

你给JobLauncherTestUtils字段添加@Qualifier("LoadAcceptanceTestDataJob")，但Spring的处理逻辑是：

1. 先找到JobLauncherTestUtils类型的Bean（如果是自动配置的，Spring会默认创建一个）
2. 然后给这个JobLauncherTestUtils注入它依赖的Job类型Bean
   这时候Spring发现存在两个Job Bean（LoadBMSJob和LoadAcceptanceTestDataJob），无法确定选哪一个，于是抛出了找不到唯一匹配Bean的错误。你的@Qualifier注解并没有告诉Spring要给JobLauncherTestUtils注入哪个Job，而是错误地标记了要注入哪个JobLauncherTestUtils——但其实你只有一个JobLauncherTestUtils实例。

正确的解决方案 #

方案1：自定义JobLauncherTestUtils Bean并指定依赖的Job

创建一个测试配置类，手动定义JobLauncherTestUtils，并明确注入你需要的Job：

@Configuration
public class BatchTestConfiguration {

    // 先通过@Qualifier获取目标Job
    @Autowired
    @Qualifier("LoadAcceptanceTestDataJob")
    private Job acceptanceTestJob;

    // 定义JobLauncherTestUtils Bean，绑定目标Job
    @Bean
    public JobLauncherTestUtils jobLauncherTestUtils() {
        JobLauncherTestUtils testUtils = new JobLauncherTestUtils();
        testUtils.setJob(acceptanceTestJob);
        return testUtils;
    }
}

然后在测试类中直接注入即可，不需要额外的@Qualifier：

@Autowired
private JobLauncherTestUtils jobLauncherUtils;

方案2：在测试类初始化时手动设置Job

如果不想新增配置类，可以在测试类的初始化方法中手动给JobLauncherTestUtils设置目标Job：

@Autowired
@Qualifier("LoadAcceptanceTestDataJob")
private Job acceptanceTestJob;

@Autowired
private JobLauncherTestUtils jobLauncherUtils;

@Before
public void setUpTestUtils() {
    // 手动指定要使用的Job
    jobLauncherUtils.setJob(acceptanceTestJob);
}

方案3：给目标Job添加@Primary（不推荐，灵活性差）

如果你希望默认情况下Spring优先选择LoadAcceptanceTestDataJob，可以给这个Job配置添加primary="true"（XML配置方式）：

<batch:job id="LoadAcceptanceTestDataJob" parent="LoadBMSJob" primary="true">
    <!-- 你的Step配置 -->
</batch:job>

这种方式的缺点是全局生效，如果其他测试或组件需要注入LoadBMSJob，会被优先注入LoadAcceptanceTestDataJob，容易引发其他问题，所以仅在单一场景下使用。

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