Spring Batch 5升级后JobRepository配置启动失败求助

针对你升级到Spring Batch 5后遇到的JobRepository启动异常、配置失效等问题，结合Spring Batch 5的核心配置变更，逐一解答如下：

核心问题根源：Spring Batch 5 的配置简化与废弃项 #

Spring Batch 5对JobRepository的自动配置做了大幅优化，同时移除了大量旧版本的配置项，手动配置时如果没有适配新的依赖关系，就会出现类似incrementerFactory为空的异常。

1. this.incrementerFactory 为空异常 #

自定义JobRepository时，必须显式注入DataFieldMaxValueIncrementerFactory。Spring Batch 5中默认的实现是DefaultDataFieldMaxValueIncrementerFactory，如果手动构建JobRepositoryBean，漏掉这个依赖注入就会触发空指针异常。

如果不需要自定义JobRepository，直接使用框架自动配置的实例即可——自动配置会自动处理所有依赖（包括incrementerFactory、数据源、事务管理器），这也是你移除自定义配置后问题解决的原因。

若确实需要自定义，正确的配置示例：

@Configuration
public class BatchCustomConfig {

    @Bean
    public JobRepository jobRepository(DataSource dataSource, 
                                       PlatformTransactionManager transactionManager,
                                       DataFieldMaxValueIncrementerFactory incrementerFactory) throws Exception {
        JobRepositoryFactoryBean factoryBean = new JobRepositoryFactoryBean();
        factoryBean.setDataSource(dataSource);
        factoryBean.setTransactionManager(transactionManager);
        factoryBean.setIncrementerFactory(incrementerFactory);
        // 可选：自定义表前缀、隔离级别等
        factoryBean.setTablePrefix("BATCH_");
        return factoryBean.getObject();
    }
}

2. 原jdbc.datasource相关配置失效 #

Spring Batch 5彻底移除了旧版本中spring.batch.jdbc.datasource这类配置项，现在统一使用Spring标准的数据源配置（spring.datasource.*），框架会自动识别并使用这个数据源初始化JobRepository。

3. schema-h2.sql 文件无法找到 #

Spring Batch 5默认不再自动加载数据库schema文件，需要显式开启初始化：

• 添加配置：spring.batch.jdbc.initialize-schema=always（仅开发环境推荐，生产环境建议手动执行schema脚本）
• 若手动指定schema文件，注意H2的schema文件路径已调整为classpath:org/springframework/batch/core/schema-h2.sql，确保路径引用正确。

4. auto-commit 属性被移除 #

Spring Batch 5内部已接管事务管理，不再允许外部配置auto-commit属性。自定义配置中若保留了setAutoCommit(false)这类代码，直接删除即可。

升级建议 #

1. 优先使用自动配置：Spring Batch 5的自动配置已经覆盖绝大多数场景，无需手动配置JobRepository，避免依赖缺失问题。
2. 清理废弃配置：移除所有旧版本中的spring.batch.jdbc.*废弃配置项，替换为Spring标准数据源配置。
3. 自定义配置需完整注入依赖：若必须自定义JobRepository，确保dataSource、transactionManager、incrementerFactory三个核心依赖全部正确注入。

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