Spring Batch 6.0.2 发布

时间：2026-08-23

Spring Batch 6.0.2 正式版来了。这次更新谈不上大刀阔斧的重构，但细节和稳定性方面的打磨，看得出项目团队是下了功夫的。如果你的项目正卡在某些“小毛病”上，或者正在从旧版本迁移，这次发版值得多看两眼。

新增功能

为 JobParametersConverter 新增对 ZonedDateTime 和 OffsetDateTime 类型的支持 #5178

以前处理带时区的时间参数多少有点别扭，现在直接通过转换器就能搞定，代码层面更清爽了。

问题修复

这次修复清单相当厚实。如果一定要挑重点来说，以下这些修复值得你特别留意：

迁移与兼容性：修复了从 CommandLineJobRunner 迁移到 CommandLineJobOperator 时，Spring Batch v5 与 v6 之间的兼容性问题 #5227。对于还在纠结要不要升级的团队，这算扫清了一个关键路障。
数据完整性与握手逻辑：MongoStepExecutionDao.countStepExecutions() 方法此前会忽略 stepName 参数 #5220，这次修了——不大，但如果不修，分步统计结果一错，后面的决策全跟着跑偏。
竞争条件与优雅关闭：优雅关闭期间因竞争条件引发的 OptimisticLockingFailureException #5217，终于有了解决方案。在高并发场景下，这个优化能省下不少排查时间。
事务边界与状态更新：修复了 ChunkOrientedStep#doExecute 在事务边界外错误更新 StepExecution 的行为 #5199，以及数据块执行失败后仍误更新 ExecutionContext、导致重启时数据丢失的问题 #5182。这两处都是对“重启可靠性”的硬核保障。
序列化与并行安全：Jackson2ExecutionContextStringSerializer 不能正确序列化 JobStep 中的作业参数 #5191；并行块处理场景下 StepContribution 计数器缺乏线程安全性 #5188；多线程 ChunkOrientedStep 中 @StepScope 注解的 ItemProcessor 抛出 ScopeNotActiveException #5183。这几条都是并行和分布式场景下的“暗坑”，修复之后，开发者的心理负担会轻不少。
数据库兼容性：DB2LUW 在迁移到 Spring Batch 6.x 后的异常 #5166 终于得到处理，DB2 用户这次可以放心升级了。
重启逻辑与资源释放：AbstractPaginatedDataItemReader.jumpToItem(int itemLastIndex) 重启逻辑不正确 #5136、AbstractCursorItemReader#doClose 中资源释放顺序不一致 #5109——属于那种“看起来不严重，但遇到一次就头疼”的问题。
其他偶发异常：使用 asyncTaskExecutor 并通过 jobOperator.start() 启动作业时偶发的 OptimisticLockingFailureException #5106，以及 StaxEventItemWriter 与 MultiResourceItemWriter 组合使用时抛出的 ClosedChannelException #5098，一并修复。
MongoDB 写入冲突：并行作业执行过程中 MongoSequenceIncrementer 出现写入冲突的问题 #4960，也做了对应处理。

功能增强

这次功能增强非常克制，主要集中在代码质量层面：使用 Spring Framework 提供的 CollectionUtils 替代原生构造方式创建 HashSet/HashMap 实例 #5175，并移除了 StoredProcedureItemReader 中的冗余断言逻辑 #5119。属于“内功修炼”，外部使用者可能感知不大，但代码可维护性和一致性确实提升了。

文档改进

文档方面，修正了 whatsnew.adoc 及集成测试代码中的拼写错误 #5207；明确说明了 Spring Batch v6 中 ChunkListener 接口行为的变化 #5226；修正了 v6 文档中关于并发步骤（concurrent steps）的错误描述 #5228；同时更新了 JobOperatorFactoryBean 的示例代码 #5103。文档质量上了一个台阶，尤其对于新上手 v6 的开发者来说，这些修正能节省不少“试错成本”。