单元测试整个Spring Batch Job报错：No qualifying bean of type Job可用

• @SpringBatchTest注解自动装配JobLauncherTestUtils时，会默认按类型注入Spring上下文中的JobBean来调用setJob方法完成初始化。你当前上下文内共注册了2个Job类型的Bean：updateNotaryDistrictsJob和updateNotaryListInfoJob，Spring无法确定要绑定的目标实例，因此抛出唯一Bean匹配失败的异常。

• 你没有为JobLauncherTestUtils显式指定绑定的目标Job，也没有对测试上下文做过滤排除不需要的Job Bean，最终导致多Job实例冲突。

以下3种方案可按使用场景选择：

方案1：手动注册指定Job的JobLauncherTestUtils #

直接在测试类中自定义JobLauncherTestUtils的Bean，显式绑定要测试的Job，优先级高于框架自动装配的实例，是灵活性最高的方案：

@SpringBootTest
@SpringBatchTest
public class NotaryJobTest {
    // 注入目标测试Job
    @Autowired
    @Qualifier("updateNotaryDistrictsJob")
    private Job targetJob;

    // 手动构造JobLauncherTestUtils并绑定目标Job
    @Bean
    public JobLauncherTestUtils jobLauncherTestUtils() {
        JobLauncherTestUtils utils = new JobLauncherTestUtils();
        utils.setJob(targetJob);
        return utils;
    }

    @Test
    public void testJobExecution() throws Exception {
        JobExecution execution = jobLauncherTestUtils.launchJob();
        // 此处可添加执行结果断言
        assertEquals(BatchStatus.COMPLETED, execution.getStatus());
    }

    // 其他注入、业务逻辑省略
}

如果后续需要测试另一个updateNotaryListInfoJob，仅修改@Qualifier指定的Bean名称即可。

方案2：测试上下文仅加载目标Job的配置 #

如果两个Job对应不同的配置类，测试时仅引入目标Job的配置类，避免加载非测试需求的Job Bean：

// 仅加载目标Job的配置和公共Batch配置，不加载另一个Job的配置类
@SpringBootTest
@SpringBatchTest
@ContextConfiguration(classes = {UpdateNotaryDistrictsJobConfig.class, CommonBatchConfig.class})
public class NotaryJobTest {
    // 此时上下文仅存在1个Job实例，自动注入不会冲突
    @Autowired
    private JobLauncherTestUtils jobLauncherTestUtils;

    // 测试方法省略
}

方案3：给高频测试Job添加@Primary注解 #

如果某个Job是主要测试对象，直接在对应配置类的Job Bean声明上添加@Primary注解，Spring自动注入时会优先选择该实例：

@Configuration
public class UpdateNotaryDistrictsJobConfig {
    @Bean
    @Primary // 标注为优先注入的Job实例
    public Job updateNotaryDistrictsJob(JobRepository jobRepository, Step updateDistrictsStep) {
        return new JobBuilder("updateNotaryDistrictsJob", jobRepository)
                .start(updateDistrictsStep)
                .build();
    }
    // 其他Step、组件配置省略
}

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