StepScope与JobScope的区别及适用场景咨询

核心本质差异 #

你之前的基础认知是准确的，二者都是Spring Batch提供的自定义作用域扩展，核心差异为实例绑定的生命周期维度不同：

• StepScope：作用域绑定到单次StepExecution（步骤执行上下文），每触发一次步骤执行就会生成一个全新的Bean实例。同一个Job下不同Step的StepScope Bean完全隔离，同一个Step多次重试、重启也会生成新的实例。
• JobScope：作用域绑定到单次JobExecution（作业执行上下文），每触发一次作业执行仅生成一个对应Bean实例。同一个Job下的所有Step共享同一个JobScope Bean实例，Job重启后会生成新的实例。

核心特性对比 #

• 初始化规则：二者默认都是懒加载，只有对应的Step/Job真正启动执行时才会初始化Bean，因此支持注入运行时动态生成的参数、上下文变量。
• 可注入参数范围：
  • StepScope Bean支持注入当前Step的StepExecution、Step上下文变量，也可注入Job级别的JobExecution、Job参数、Job上下文变量
  • JobScope Bean仅支持注入Job级别的运行时数据，无法获取Step级别的上下文和参数
• 隔离粒度：StepScope > JobScope > Spring默认Singleton/Prototype作用域

适用场景 #

StepScope 适用场景 #

• 每个Step需要独立状态的组件：比如分片读取的ItemReader、多Step流程中每个Step需要独立配置的字段映射规则、步骤级别的统计计数器
• 需要获取Step级运行时参数的场景：比如动态读取当前Step的分片序号、步骤执行状态调整业务逻辑
• 步骤重试/重启需要重置组件状态的场景：比如步骤执行失败重试时，需要重新初始化ItemReader避免读取位置错乱

示例代码：

@StepScope
@Component
public class CustomItemReader implements ItemReader<BusinessData> {
    // 注入当前Step上下文的分片ID参数
    @Value("#{stepExecutionContext['partitionId']}")
    private Long partitionId;
}

JobScope 适用场景 #

• 同一个Job下多个Step需要共享的公共组件：比如全局参数配置加载器、跨Step的业务数据缓存、Job级别的统一埋点统计组件
• 需要注入Job级运行时参数的场景：比如动态获取Job启动传入的租户ID、业务日期，供所有Step复用
• 需要在整个Job执行周期内保留状态的场景：比如统计整个Job处理的总数据量、异常次数，最终写入Job执行结果日志

示例代码：

@JobScope
@Component
public class JobGlobalConfig {
    // 注入Job启动传入的业务日期参数
    @Value("#{jobParameters['bizDate']}")
    private String bizDate;
}

常见使用误区 #

• 无状态的通用工具类不要使用这两个作用域，会增加不必要的实例创建开销，直接使用默认Singleton作用域即可
• 不要在JobScope Bean中引用StepScope Bean，会导致初始化依赖异常：JobScope Bean初始化时Step还未启动，StepScope Bean尚未生成
• 单Step场景下如果不需要跨Step共享状态，优先使用StepScope即可，无需使用JobScope

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