Spring Batch 5.x迁移报错：未注册名为'job'的作用域

错误原因 #

Spring Batch 5 对@JobScope和@StepScope的注册逻辑做了调整：默认情况下@EnableBatchProcessing不再自动注册这两个作用域，这就是触发java.lang.IllegalStateException: No Scope registered for scope name 'job'的核心原因。

两种解决方案 #

方案1：通过@EnableBatchProcessing显式启用作用域 #

修改配置类的注解，开启作用域自动注册：

@Configuration
@EnableBatchProcessing(registerJobScope = true, registerStepScope = true)
public class ProductFetcherJobConfiguration {
    // 原有代码保持不变
}

方案2：手动注册作用域Bean #

如果需要更灵活的控制，可以手动在配置类中添加作用域Bean的定义：

@Configuration
@EnableBatchProcessing
public class ProductFetcherJobConfiguration {

    @Bean
    public JobScope jobScope() {
        JobScope scope = new JobScope();
        scope.setProxyTargetClass(true);
        return scope;
    }

    @Bean
    public StepScope stepScope() {
        StepScope scope = new StepScope();
        scope.setProxyTargetClass(true);
        return scope;
    }

    // 原有业务代码不变
}

额外优化建议 #

你当前代码中直接调用@StepScope/@JobScope标注的Bean方法（比如productWebDownloadReader()），这种写法可能导致作用域Bean提前初始化，建议改为依赖注入的方式获取Bean，避免作用域失效：

例如修改downloadProductDocuments方法：

@Bean
public Step downloadProductDocuments(JobRepository jobRepository, PlatformTransactionManager transactionManager,
                                     ProductDownloadReader productWebDownloadReader,
                                     ProductDownloadProcessor productWebDownloadProcessor,
                                     ProductDownloadWriter productWebDownloadWriter,
                                     ProductDownloadChunkListener productWebChunkListener) {
    return new StepBuilder("downloadProductDocuments", jobRepository)
            .<String, String>chunk(PRODUCT_CHUNK_SIZE, transactionManager)
            .reader(productWebDownloadReader)
            .processor(productWebDownloadProcessor)
            .writer(productWebDownloadWriter)
            .listener(productWebChunkListener)
            .build();
}

同理，productFetcherJob方法也应调整为注入依赖：

@Bean
public Job productFetcherJob(JobRepository jobRepository,
                             Step productLinkListFetcher,
                             Step downloadProductDocuments,
                             ProductFetcherJobListener productFetcherJobListener) {
    return new JobBuilder("productFetcherJob", jobRepository)
            .incrementer(new RunIdIncrementer())
            .start(productLinkListFetcher)
            .next(downloadProductDocuments)
            .listener(productFetcherJobListener)
            .build();
}

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