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 更偏向于“查漏补缺”型发布。但对于那些正处于版本迁移节点、或者在并行与高可靠场景下有明确需求的团队而言,此次更新的几乎每一行修复都具有很强的针对性。
