Spring Batch多任务多数据源配置问题：元数据表格仅生成于主数据源且任务执行后未填充

咱们来拆解你遇到的问题：多Batch子模块+多数据源场景下，Batch元数据表仅在@Primary数据源创建但无数据，核心原因是Batch核心组件（JobRepository、JobLauncher等）与数据源/事务管理器的绑定不匹配，以及配置类的重复定义导致的Bean冲突。下面分点说明错误点和修正方案：

1. 错误：@EnableBatchProcessing与自定义SimpleBatchConfiguration的冲突 #

你在CommonBatchConfig上标注了@EnableBatchProcessing，同时又自定义了CommonBatchConfigurer继承SimpleBatchConfiguration，还通过@ComponentScan导入它。但@EnableBatchProcessing本身就会自动导入SimpleBatchConfiguration，这会导致Spring容器中出现重复的Batch核心Bean定义，优先级混乱，最终Job执行时无法正确关联到对应的数据源和事务管理器。

修正方案： #

移除CommonBatchConfig上的@EnableBatchProcessing，改用自定义的BatchConfigurer来完全控制Batch组件的创建。同时，每个Batch子模块应该对应自己的BatchConfigurer，绑定各自的数据源和事务管理器。

2. 错误：共用单一BatchConfigurer无法适配多数据源场景 #

你的CommonBatchConfigurer只绑定了commonDataSource和对应的事务管理器，但其他子模块（batch-two、batch-three）有自己的数据源，却没有对应的BatchConfigurer。这会导致所有Batch任务都试图使用commonDataSource的JobRepository，但如果子模块的任务用的是自己的事务管理器，就会出现事务上下文不匹配，元数据无法写入。

修正方案： #

为每个子模块创建独立的BatchConfigurer，绑定各自的数据源和事务管理器：

比如为batch-two创建SecondBatchConfigurer：

@Component
@Import({PersistenceSecondAutoConfiguration.class})
public class SecondBatchConfigurer extends SimpleBatchConfiguration {
    @Qualifier("secondTransactionManager")
    @Autowired
    private PlatformTransactionManager transactionManager;

    @Bean
    BatchConfigurer secondBatchConfigurer(@Qualifier("secondDataSource") DataSource dataSource) {
        return new DefaultBatchConfigurer() {
            @Override
            public void setDataSource(DataSource dataSource) {
                super.setDataSource(dataSource);
            }

            @Override
            public PlatformTransactionManager getTransactionManager() {
                return transactionManager;
            }
        };
    }
}

然后在batch-two的任务配置类中，导入对应的SecondBatchConfigurer，而不是共用CommonBatchConfigurer：

@Slf4j
@Configuration
@EnableScheduling
@RequiredArgsConstructor
@ComponentScan(basePackageClasses = SecondBatchConfigurer.class)
public class SecondBatchConfig {
    private final JobLauncher jobLauncher;
    private final Job secondBatchJob;

    @Scheduled(cron = "${spring.batch.scheduler.cron.second}")
    public void launchSecondJob() throws Exception {
        JobParameters param = new JobParametersBuilder().addString("JobID", String.valueOf(System.currentTimeMillis())).toJobParameters();
        JobExecution execution = jobLauncher.run(secondBatchJob, param);
        log.info("Second Job finished with status : {}", execution.getStatus());
    }
}

3. 错误：JobRepository的自动创建未关联正确的数据源 #

当使用多数据源时，DefaultBatchConfigurer默认会查找@Primary数据源，但如果你的子模块任务需要使用自己的数据源存储Batch元数据，必须确保对应的BatchConfigurer覆盖createJobRepository()方法，显式使用指定的数据源和事务管理器初始化JobRepository。

修正方案： #

在每个BatchConfigurer中，覆盖createJobRepository()方法，确保JobRepository绑定到当前数据源：

@Override
protected JobRepository createJobRepository() throws Exception {
    JobRepositoryFactoryBean factory = new JobRepositoryFactoryBean();
    factory.setDataSource(dataSource);
    factory.setTransactionManager(transactionManager);
    factory.setDatabaseType(DatabaseType.MYSQL.name()); // 根据你的数据库类型调整
    factory.afterPropertiesSet();
    return factory.getObject();
}

这样就能保证每个子模块的Batch元数据会创建在自己的数据源中，并且任务执行时能正确写入数据。

4. 额外注意：避免@Primary数据源的干扰 #

如果你的每个子模块都需要独立的Batch元数据表，建议移除数据源上的@Primary注解（除非有其他业务必须依赖它），然后在每个BatchConfigurer中显式指定要使用的数据源，避免Spring自动注入错误的数据源。

另外，确保每个子模块的JPA配置（@EnableJpaRepositories）只扫描自己的实体和Repository包，避免跨模块的数据源污染。

按照上述方案调整后，每个Batch子模块会拥有独立的Batch核心组件（JobRepository、JobLauncher等），绑定自己的数据源和事务管理器，元数据表会正确创建并在任务执行后填充数据。

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