Spring Batch 5升级报错：未注册Step作用域（非Spring Boot环境）

手动注册StepScope相关Bean #

只注册StepScope.class是不够的，需要完整初始化StepScope实例并配置代理模式，确保Spring容器能识别这个作用域。以下两种方式都可以解决问题：

方式一：通过@Configuration注册StepScope Bean #

创建配置类，直接实例化StepScope并开启CGLIB代理（避免代理创建失败）：

import org.springframework.batch.core.scope.StepScope;
import org.springframework.batch.core.scope.JobScope;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;

@Configuration
public class BatchScopeConfig {

    @Bean
    public StepScope stepScope() {
        StepScope stepScope = new StepScope();
        // 必须设置该属性，否则step作用域Bean的代理创建可能失败
        stepScope.setProxyTargetClass(true);
        return stepScope;
    }

    // 若需要job作用域，同步注册JobScope
    @Bean
    public JobScope jobScope() {
        JobScope jobScope = new JobScope();
        jobScope.setProxyTargetClass(true);
        return jobScope;
    }
}

Spring容器会自动识别Scope类型的Bean，将其注册为容器的作用域，此时@Scope("step")或@StepScope就能正常生效。

方式二：通过BeanFactoryPostProcessor手动注册作用域 #

如果方式一不生效，可以直接将StepScope注册到BeanFactory中：

import org.springframework.batch.core.scope.StepScope;
import org.springframework.batch.core.scope.JobScope;
import org.springframework.beans.factory.config.BeanFactoryPostProcessor;
import org.springframework.beans.factory.config.ConfigurableListableBeanFactory;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;

@Configuration
public class BatchScopeConfig {

    @Bean
    public BeanFactoryPostProcessor stepScopeRegistrar() {
        return (ConfigurableListableBeanFactory beanFactory) -> {
            StepScope stepScope = new StepScope();
            stepScope.setProxyTargetClass(true);
            beanFactory.registerScope("step", stepScope);
            
            // 可选：注册job作用域
            JobScope jobScope = new JobScope();
            jobScope.setProxyTargetClass(true);
            beanFactory.registerScope("job", jobScope);
        };
    }
}

验证Reader Bean的定义 #

确保你的Reader Bean正确标注了作用域，示例如下：

import org.springframework.batch.item.ItemReader;
import org.springframework.beans.factory.annotation.Value;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Scope;

@Bean
@Scope("step") // 也可以用@StepScope（需确保依赖spring-batch-core包）
public ItemReader<String> customReader(@Value("#{jobParameters['inputFilePath']}") String inputFilePath) {
    // 初始化Reader并传入JobParameters参数
    return new MyCustomFileReader(inputFilePath);
}

如果使用@StepScope注解，需确保项目依赖中包含spring-batch-core包，该注解定义在这个包内。

关键注意点 #

• proxyTargetClass=true必须设置：StepScope的Bean需要代理支持，若目标类未实现接口，默认JDK动态代理会失败，开启该属性会使用CGLIB代理，适配所有类类型。
• 无需额外注册Batch核心Bean：只要正确注册StepScope，就能正常获取JobParameters或StepExecution相关参数。

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