Spring Batch 6.0.2 正式发布

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 的开发者而言，这些修正能大幅节省“试错成本”。

任务类更新

更新了问题报告指南中的项目模板内容 #5212。虽然改动不大，但对规范社区反馈流程具有积极意义。

依赖版本升级

依赖库完成了一轮同步升级：

• Spring Framework：7.0.3
• Spring Integration：7.0.2
• Spring AMQP：4.0.2
• Spring Kafka：4.0.2
• Spring Data：4.0.2
• Micrometer：1.16.2

总体来看，Spring Batch 6.0.2 更偏向于“查漏补缺”型发布。但对于那些正处于版本迁移节点、或者在并行与高可靠场景下有明确需求的团队而言，此次更新的几乎每一行修复都具有很强的针对性。