Spring Batch 5 模块化作业配置：以条件加载实现无冲突多作业管理

本文详解如何在 Spring Boot 3 + Spring Batch 5 环境下，无需 @EnableBatchProcessing(modular = true) 即可安全实现多作业（Job）隔离部署，通过 @ConditionalOnProperty 动态激活配置类，彻底规避 Bean 冲突与手动全量配置负担。

本文详解如何在 spring boot 3 + spring batch 5 环境下，无需 `@enablebatchprocessing(modular = true)` 即可安全实现多作业（job）隔离部署，通过 `@conditionalonproperty` 动态激活配置类，彻底规避 bean 冲突与手动全量配置负担。

Spring Batch 5 对批处理上下文模型进行了重要演进：@EnableBatchProcessing(modular = true) 不再是“轻量模块化开关”，而是显式关闭全部自动配置的强干预注解——启用后，开发者需自行注册 JobRepository、JobLauncher、TransactionManager、元数据表初始化逻辑等全套基础设施，极易引入遗漏或配置偏差，显著增加维护成本。

因此，官方推荐路径是：放弃 modular=true，回归 Spring Boot 的自动配置哲学，转而用 Spring 的条件化机制（Conditional Configuration）实现逻辑隔离。核心思路不是“物理隔离上下文”（如旧版 ApplicationContextFactory），而是“按需激活配置”，让每个 Job 的配置类仅在明确指定其名称时才被加载，从而天然避免 NoUniqueBeanDefinitionException 等 Bean 冲突问题。

✅ 推荐迁移方案：基于 @ConditionalOnProperty 的声明式作业激活

以 BatchJobAConfiguration 为例，改造步骤如下：

1. 移除所有 @EnableBatchProcessing(modular = true) 相关配置（包括 MyModularBatchJobContextConfiguration 类）；
2. 为每个 Job 配置类添加 @Configuration 和精准条件注解；
3. 确保 spring.batch.job.enabled=false（禁用启动时默认执行），避免冲突触发。

@Configuration@ConditionalOnProperty(    prefix = "spring.batch.job",    name = "name",    havingValue = "job-a",  // 仅当 --spring.batch.job.name=job-a 时生效    matchIfMissing = false)public class BatchJobAConfiguration {    private static final String JOB_NAME = "job-a";    private static final String STEP_NAME = "step-a";    @Autowired    private EntityManagerFactory emf;    @Bean    public Job jobA(JobRepository jobRepository, Step stepA) {        return jobBuilderFactory(jobRepository)                .get(JOB_NAME)                .start(stepA)                .end()                .build();    }    @Bean    public Step stepA(JobRepository jobRepository,                      JpaTransactionManager transactionManager,                      FlatFileItemReader<MyEntity> reader,                      ItemProcessor<MyEntity, MyEntity> processor,                      JpaItemWriter<MyEntity> writer) {        return stepBuilderFactory(jobRepository)                .get(STEP_NAME)                .<MyEntity, MyEntity>chunk(10, transactionManager)                .reader(reader)                .processor(processor)                .writer(writer)                .build();    }    @Bean    @Primary // 若全局仅一个 JPA TransactionManager，建议加 @Primary；多 Job 场景下推荐使用限定名+@Qualifier    public JpaTransactionManager jobATransactionManager() {        JpaTransactionManager tm = new JpaTransactionManager();        tm.setEntityManagerFactory(emf);        return tm;    }    // Reader / Processor / Writer 定义（略）}

同理，BatchJobBConfiguration 使用 havingValue = "job-b"，依此类推。所有配置类均保持 @Configuration，但仅当 JVM 参数匹配时才注入容器。

⚙️ 启动与调用方式（IDE / CLI / Data Flow 兼容）

• 本地 IDE/CLI 执行：

  java -jar my-batch-app.jar --spring.batch.job.name=job-a# 或java -jar my-batch-app.jar --spring.batch.job.name=job-b

• Spring Cloud Data Flow：
  在 Task Definition 中设置 spring.batch.job.name=job-a 作为 Launch Parameters，SCDF 将透传该参数，自动激活对应配置。

• 关键配置项（application.yml）：

  spring:  batch:    job:      enabled: false  # 必须关闭自动启动，否则会尝试运行未激活的 Job    initialize-schema: always  # 生产环境建议设为 embedded 或 never，由 DBA 统一建表  datasource:    url: jdbc:postgresql://localhost:5432/batchdb    # ... 其他 DataSource 配置

⚠️ 注意事项与最佳实践

• @Primary 谨慎使用：若多个 Job 均定义 JpaTransactionManager，且未加 @ConditionalOnProperty，仍会冲突。此时应统一使用 @Qualifier("jobAtransactionManager") 注入，并在 @Bean 上标注 @Qualifier("jobAtransactionManager") —— 但更优解仍是严格依赖条件激活，避免共存。
• JobRepository 共享是安全的：Spring Batch 5 默认复用单个 JobRepository（基于共享数据库），它通过 JOB_INSTANCE_ID 和 JOB_EXECUTION_ID 天然隔离不同 Job 的元数据，无需为每个 Job 创建独立 Repository。
• 资源（Resource）Bean 冲突？：Resource 是 Spring 核心接口（如 ClassPathResource, FileSystemResource），若自定义了同名 Bean，务必重命名（如 jobAInputResource()）或加 @Qualifier；但通常建议直接在 ItemReader 内部构造 Resource，避免暴露为顶层 Bean。
• 测试验证：编写集成测试时，可通过 SpringApplication 编程式启动并传参：

  new SpringApplicationBuilder(MyBatchApplication.class)    .properties("spring.batch.job.name=job-a")    .run();

该方案完全兼容 Spring Boot 3.2+ 与 Spring Batch 5.0+，零侵入、低维护、高可扩展——新增第 5 个 Job，只需复制一份配置类，修改 havingValue 和内部 Bean 名称即可，无需触碰任何基础设施代码。这才是现代 Spring 批处理工程化的正确打开方式。