Spring Batch 3迁移至5.1.1遇NoUniqueBeanDefinitionException求优化方案

以下是几种更简洁合理的优化方案，避免重复使用@Qualifier或新增不必要的类字段：

1. 直接调用Step的@Bean方法构建Job #

在同一个配置类中，@Bean标注的方法可以直接互相调用，Spring会自动处理Bean的生命周期（保证单例、依赖注入等特性）。这种方式显式明确，无需依赖自动注入的匹配逻辑：

@Configuration
public class BatchJobConfig {

    @Bean
    public Step step1(JobRepository jobRepository, PlatformTransactionManager transactionManager) {
        return new StepBuilder("step1", jobRepository)
                .tasklet((contribution, chunkContext) -> RepeatStatus.FINISHED, transactionManager)
                .build();
    }

    @Bean
    public Step step2(JobRepository jobRepository, PlatformTransactionManager transactionManager) {
        return new StepBuilder("step2", jobRepository)
                .tasklet((contribution, chunkContext) -> RepeatStatus.FINISHED, transactionManager)
                .build();
    }

    @Bean
    public Job multiStepJob() {
        // 直接调用配置类内的step1()和step2()方法获取Bean实例
        return new JobBuilder("multiStepJob", jobRepository())
                .start(step1(jobRepository(), transactionManager()))
                .next(step2(jobRepository(), transactionManager()))
                .build();
    }

    // 基础组件Bean定义
    @Bean
    public JobRepository jobRepository() { /* 实现逻辑 */ }
    @Bean
    public PlatformTransactionManager transactionManager() { /* 实现逻辑 */ }
}

2. 利用参数名称与Bean名称自动匹配 #

Spring默认会根据@Bean方法参数的实际名称匹配对应的Bean（需保证编译时保留参数名称）。只要参数名和Step Bean的名称一致，无需添加@Qualifier即可完成注入：

@Configuration
public class BatchJobConfig {

    @Bean
    public Step step1(JobRepository jobRepository, PlatformTransactionManager transactionManager) {
        return new StepBuilder("step1", jobRepository)
                .tasklet((contribution, chunkContext) -> RepeatStatus.FINISHED, transactionManager)
                .build();
    }

    @Bean
    public Step step2(JobRepository jobRepository, PlatformTransactionManager transactionManager) {
        return new StepBuilder("step2", jobRepository)
                .tasklet((contribution, chunkContext) -> RepeatStatus.FINISHED, transactionManager)
                .build();
    }

    // 参数名step1、step2与对应的Bean名称完全一致
    @Bean
    public Job multiStepJob(Step step1, Step step2, JobRepository jobRepository) {
        return new JobBuilder("multiStepJob", jobRepository)
                .start(step1)
                .next(step2)
                .build();
    }

    // 基础组件Bean定义
    @Bean
    public JobRepository jobRepository() { /* 实现逻辑 */ }
    @Bean
    public PlatformTransactionManager transactionManager() { /* 实现逻辑 */ }
}

注意事项 #

使用这种方式时，需要确保编译时保留参数名称：

• Maven项目：在pom.xml的maven-compiler-plugin中添加<parameters>true</parameters>配置
• Gradle项目：在build.gradle中设置compileJava.options.compilerArgs.add '-parameters'
• IDE中开启保留参数名称的编译选项（通常默认开启）

不推荐的方案：使用@Primary #

虽然@Primary可以指定默认注入的Step，但这种方式会导致全局范围内注入Step时都优先选择该Bean，容易引发其他业务场景的注入歧义，因此不建议在多Step的Job场景中使用。

内容的提问来源于stack exchange，提问作者Rémi