SpringBatch4升级SpringBatch5踩坑指南

三暮辰

已于 2024-09-02 10:12:37 修改

阅读量535

点赞数 8

分类专栏： springboot 文章标签： spring boot spring

于 2024-09-02 09:20:16 首次发布

本文链接：https://blog.csdn.net/qq_41565000/article/details/141805952

版权

springboot 专栏收录该内容

3 篇文章 0 订阅

订阅专栏

SpringBatch5使用JDK17作为基线版本，若项目未升级，亦无需升级springbatch。

报错1:JobParameter类型问题

报错内容：
java.util.Map.Entry<java.lang.String,org.springframework.batch.core.JobParameter<?>>无法转换为java.util.Map.Entry<java.lang.String,org.springframework.batch.core.JobParameter>
参考：

https://github.com/spring-projects/spring-batch/wiki/Spring-Batch-5.0-Migration-Guide#job-parameters-handling-updates
https://springdoc.cn/spring-batch/whatsnew.html#job-parameters-handling-updates

原因：SpringBatch4只有4种预定义的类型（long、double、string、date），SpringBatch5版本增加了对使用任何类型作为 job 参数的支持
解决方案：将使用到JobParameter的地方适配为JobParameter<?>

报错2:JobBuilderFactory已弃用

报错内容：
JobBuilderFactory和StepBuilderFactory已弃用

参考：https://github.com/spring-projects/spring-batch/wiki/Spring-Batch-5.0-Migration-Guide#infrastructure-beans-configuration-with-enablebatchprocessing
https://springdoc.cn/spring-batch/job.html#configuringAJob
https://docs.spring.io/spring-batch/reference/job/configuring.html
原因：JobBuilderFactory和StepBuilderFactory在SpringBatch5中已弃用
解决方案：使用JobBuilder和StepBuilder创建
JobConfigurer上添加注解@EnableBatchProcessing，自动注入以下bean或重写以下bean

@Autowired
private JobRepository jobRepository;
@Autowired
private PlatformTransactionManager transactionManager;

或者可将JobConfigurer继承自DefaultBatchJobConfigur

报错3：@AfterWrite参数变更

报错内容：
Error creating bean with name 'JobControllerImpl' Caused by: java.lang.IllegalArgumentException: The method [afterWrite] on target class [XxxListener] is incompatible with the signature [(Chunk)] expected for the annotation [AfterWrite].
位置：Listener
参考：https://springdoc.cn/spring-batch/readersAndWriters.html#itemWriter
解决方案：将@AfterWrite注解的方法参数由List改为Chunk

报错4：SimpleJobLauncher不再使用

报错内容：
SimpleJobLauncher不再使用
位置：SpringBatchConfigurer
参考：https://springdoc.cn/spring-batch/job.html#configuringJobLauncher
https://docs.spring.io/spring-batch/reference/job/configuring-launcher.html
解决方案：使用TaskExecutorJobLauncher jobLauncher = new TaskExecutorJobLauncher();替代

报错5：springbatch表前缀不生效

报错内容：
springbatch表前缀不生效
（application-dev.yaml中spring.batch.jdbc.table-prefix:xxx_）
本项目遇到的报错为使用MySQL作为job数据管理所遇见，其他数据库尚未测试
参考：https://springdoc.cn/spring-batch/job.html#repositoryTablePrefix
临时解决方案：在 SpringBatchConfigurer的注解上添加@EnableBatchProcessing(tablePrefix = “xxx_”)
结论：本地生效，部署到容器中不生效，未解决

报错6：java.lang.ClassNotFoundException: DATE

java.lang.RuntimeException: java.lang.ClassNotFoundException: DATE at org.springframework.batch.core.repository.dao.JdbcJobExecutionDao.lambda$getJobParameters$2(JdbcJobExecutionDao.java:472) at org.springframework.jdbc.core.JdbcTemplate$RowCallbackHandlerResultSetExtractor.extractData(JdbcTemplate.java:1762) at org.springframework.jdbc.core.JdbcTemplate$1.doInPreparedStatement(JdbcTemplate.java:733) ... xxx ...
Caused by: java.lang.ClassNotFoundException: DATE at java.base/jdk.internal.loader.BuiltinClassLoader.loadClass(BuiltinClassLoader.java:641) at java.base/jdk.internal.loader.ClassLoaders$AppClassLoader.loadClass(ClassLoaders.java:188) at java.base/java.lang.ClassLoader.loadClass(ClassLoader.java:520) at java.base/java.lang.Class.forName0(Native Method) at java.base/java.lang.Class.forName(Class.java:375) at org.springframework.batch.core.repository.dao.JdbcJobExecutionDao.lambda$getJobParameters$2(JdbcJobExecutionDao.java:469) ... 91 common frames omitted
此处遇到的可能是java.lang.RuntimeException: java.lang.ClassNotFoundException: STRING，原理相同
相关原因：https://github.com/spring-projects/spring-batch/wiki/Spring-Batch-5.0-Migration-Guide#data-types-updates
根本原因：https://github.com/spring-projects/spring-batch/issues/4352

相关说明：https://github.com/spring-projects/spring-batch/wiki/Spring-Batch-5.0-Migration-Guide#historical-data-access-implications.

新启动的job会查询最后一个实例来进行参数变更，如id自增等。查询到最后一个实例后，进行映射。老数据的parameter类型为DATE，新的为java.util.Date，故无法找到类型DATE
在以上issue中，给出声明，老的数据和新数据不应该再有交互。
解决方案：
planA.将表中的DATE修改为java.util.Date
planB.使用springBatch5的建表语句重建表