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://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/issues/4352
新启动的job会查询最后一个实例来进行参数变更,如id自增等。查询到最后一个实例后,进行映射。老数据的parameter类型为DATE,新的为java.util.Date,故无法找到类型DATE
在以上issue中,给出声明,老的数据和新数据不应该再有交互。
解决方案:
planA.将表中的DATE修改为java.util.Date
planB.使用springBatch5的建表语句重建表
报错7:其他报错参考
- 运行报错Unable to make public final java.lang.Object java.util.HashMap$Node.getKey() accessible: module java.base does not "opens java.util" to unnamed module @3f6b0be5
- 解决报错Failed to configure a DataSource: 'url' attribute is not specified and no embedded datasource could be configured.Reason: Failed to determine a suitable driver class