Spring Batch在K8s SCDF Pod运行报错：无法加载org.mariadb.jdbc.Driver

一、核心问题定位 #

异常提示无法加载驱动类org.mariadb.jdbc.Driver，本质是K8s Pod内的应用classpath中缺失MariaDB驱动依赖，或是依赖加载逻辑在K8s环境下存在差异。

二、排查步骤 #

1. 检查Pod内依赖包完整性 #

• 进入异常Pod：

  kubectl exec -it <你的Batch应用Pod名称> -- /bin/bash
  

• 查看应用依赖目录下是否存在MariaDB驱动包：

  ls /app/libs | grep mariadb
  

  若未找到，说明依赖未被正确打包或挂载到Pod中。

2. 核对SCDF的依赖管理配置 #

• 检查SCDF在K8s部署时的全局依赖配置，或部署该Batch应用时的自定义依赖参数，确认是否遗漏了MariaDB驱动的引入。SCDF会统一管理应用依赖，若未明确声明，会导致Pod内缺失该依赖。
• 排查SCDF部署应用时的--maven.remote-repositories等参数，确认是否因仓库配置问题导致依赖拉取失败。

3. 验证K8s环境下配置文件的有效性 #

• 确认K8s环境中应用实际加载的配置文件（如是否为application-dev.yml），检查数据源驱动类配置是否正确：

  spring:
    datasource:
      driver-class-name: org.mariadb.jdbc.Driver
  

• 检查K8s中是否通过ConfigMap/Secret覆盖了数据源配置，导致驱动类被错误修改。

4. 核对镜像构建与推送一致性 #

• 虽然本地Docker运行正常，但需确认推送到K8s镜像仓库的镜像与本地测试版本一致：

  docker inspect <你的镜像标签> | grep -A 10 "Cmd"
  

  检查镜像启动命令，确认构建过程中是否遗漏了依赖打包步骤（如Maven的package或spring-boot:build-image命令是否正确执行）。

三、解决建议 #

1. 明确声明MariaDB驱动依赖 #

在pom.xml中直接添加MariaDB驱动依赖，避免依赖传递缺失：

<dependency>
    <groupId>org.mariadb.jdbc</groupId>
    <artifactId>mariadb-java-client</artifactId>
    <version>3.3.3</version> <!-- 使用与Spring Boot版本适配的稳定版本 -->
    <scope>runtime</scope>
</dependency>

设置scope为runtime，确保打包时该依赖被包含进应用包。

2. 配置SCDF正确加载依赖 #

若使用SCDF的Maven依赖管理，部署应用时指定MariaDB驱动的坐标：

dataflow:>app register --name my-batch-app --type task --uri maven://com.example:my-batch-app:1.0.0 --metadata "maven.remote-repositories=central::default::https://repo1.maven.org/maven2"

也可在SCDF全局配置中添加该依赖，确保所有应用均可获取。

3. 重新构建并验证镜像 #

重新构建镜像并推送至仓库，确保依赖打包完整：

./mvnw spring-boot:build-image -Dspring-boot.build-image.imageName=你的镜像仓库地址/my-batch-app:1.0.0
docker push 你的镜像仓库地址/my-batch-app:1.0.0

本地重新运行镜像验证依赖存在后，再部署到K8s环境。

4. 检查K8s环境类路径配置 #

若应用在K8s中使用自定义类路径配置，确保MariaDB驱动jar包路径被包含在类路径中。可通过Pod启动命令的-cp参数指定，或设置CLASSPATH环境变量。

四、额外验证手段 #

• 在Pod内手动上传MariaDB驱动jar包，重启应用确认是否能正常启动，以此验证是否为依赖缺失问题。
• 对比本地、Docker、K8s环境的JVM参数，排查是否存在影响类加载的参数差异。

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