运行Spring Batch JSR 352官方示例出现类未找到报错如何解决

问题根因 #

报错的核心是Spring Batch对JSR-352规范的默认实现依赖Apache Commons DBCP2连接池，你的项目缺少该依赖导致类加载失败，同时你的作业启动代码存在参数错误需要修正。

解决方案 #

方案1：引入缺失的DBCP2依赖（最快解决） #

根据你的项目构建工具添加对应依赖：

Maven项目（pom.xml）

<dependency>
    <groupId>org.apache.commons</groupId>
    <artifactId>commons-dbcp2</artifactId>
    <version>2.9.0</version>
</dependency>

Gradle项目（build.gradle）

implementation 'org.apache.commons:commons-dbcp2:2.9.0'

方案2：自定义数据源覆盖默认配置（适合不想用DBCP2的场景） #

如果要使用Spring Boot默认的HikariCP或者其他数据源，你可以自定义配置覆盖Spring Batch的默认数据源：

1. 在resources/META-INF路径下创建batch.xml文件，添加自定义数据源配置：

<?xml version="1.0" encoding="UTF-8"?>
<beans xmlns="http://www.springframework.org/schema/beans"
       xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
       xsi:schemaLocation="http://www.springframework.org/schema/beans
        http://www.springframework.org/schema/beans/spring-beans.xsd">

    <!-- 以HikariCP为例，可替换为你需要的数据源实现 -->
    <bean id="dataSource" class="com.zaxxer.hikari.HikariDataSource">
        <property name="jdbcUrl" value="你的数据库JDBC地址"/>
        <property name="username" value="数据库用户名"/>
        <property name="password" value="数据库密码"/>
        <property name="driverClassName" value="数据库驱动类名"/>
    </bean>

    <bean id="transactionManager" class="org.springframework.jdbc.datasource.DataSourceTransactionManager">
        <property name="dataSource" ref="dataSource"/>
    </bean>
</beans>

2. 确保你的项目中已经引入对应数据源的依赖，比如使用HikariCP需要确认Spring Boot JDBC依赖已引入，或者手动添加HikariCP依赖。

额外必填修正 #

你的作业启动代码参数有误：JobOperator.start()的第一个参数是作业ID，不是XML文件名，你需要修改为XML中job标签的id值，同时确认META-INF/batch-jobs下的XML文件名和作业ID一致：

// 你当前的错误写法
// operator.start("job-batch-demo.xml", new Properties());
// 修改为如下，对应你XML中job的id="fooJob"，同时把XML文件改名为fooJob.xml
operator.start("fooJob", new Properties());

内容的提问来源于stack exchange，提问作者Jack