对于最新的稳定版本,请使用 Spring Boot 3.4.0spring-doc.cadn.net.cn

批处理应用程序

当人们从 Spring Boot 应用程序中使用 Spring Batch 时,经常会出现许多问题。 本节将解决这些问题。spring-doc.cadn.net.cn

指定 Batch 数据源

默认情况下,批处理应用程序需要一个DataSource以存储作业详细信息。 Spring Batch 需要一个DataSource默认情况下。 要让它使用DataSource除了应用程序的 mainDataSource,声明一个DataSourcebean,为其@Beanmethod 替换为@BatchDataSource. 如果您这样做并且需要两个数据源,请记住标记另一个数据源@Primary. 要获得更大的控制权,请添加@EnableBatchProcessing到你的@Configuration类或 extendDefaultBatchConfiguration. 请参阅 API 文档@EnableBatchProcessingDefaultBatchConfiguration了解更多详情。spring-doc.cadn.net.cn

有关 Spring Batch 的更多信息,请参阅 Spring Batch 项目页面spring-doc.cadn.net.cn

指定 Batch Transaction Manager

指定批处理数据源类似,您可以定义PlatformTransactionManager用于批处理,将其标记为@BatchTransactionManager. 如果您这样做并且想要两个事务管理器,请记住将另一个标记为@Primary.spring-doc.cadn.net.cn

在启动时运行 Spring Batch 作业

Spring Batch 自动配置是通过添加spring-boot-starter-batch添加到应用程序的 Classpath 中。spring-doc.cadn.net.cn

如果单个Jobbean 在应用程序上下文中,它在启动时执行(参见JobLauncherApplicationRunner了解详情)。 如果多个Jobbean 中,必须使用spring.batch.job.name.spring-doc.cadn.net.cn

要禁用运行Job在应用程序上下文中,将spring.batch.job.enabledfalse.spring-doc.cadn.net.cn

从命令行运行

Spring Boot 将任何以 开头的命令行参数转换为要添加到--Environment,请参阅访问命令行属性。 这不应用于将参数传递给批处理作业。 要在命令行上指定批处理参数,请使用常规格式(即 without ),如以下示例所示:--spring-doc.cadn.net.cn

$ java -jar myapp.jar someParameter=someValue anotherParameter=anotherValue

如果指定Environment在命令行中,作业将忽略它。 请考虑以下命令:spring-doc.cadn.net.cn

$ java -jar myapp.jar --server.port=7070 someParameter=someValue

这仅向批处理作业提供一个参数:someParameter=someValue.spring-doc.cadn.net.cn

重新启动已停止或失败的作业

重新启动失败的Job,则必须在命令行上重新指定所有参数(标识和非标识)。 非标识参数不会从上一次执行中复制。 这允许修改或删除它们。spring-doc.cadn.net.cn

当您使用自定义JobParametersIncrementer,您必须收集 Incrementer 管理的所有参数才能重新启动失败的执行。

存储 Job Repository

Spring Batch 需要一个数据存储Job存储 库。 如果使用 Spring Boot,则必须使用实际的数据库。 请注意,它可以是内存数据库,请参阅配置 Job Repositoryspring-doc.cadn.net.cn