如何定位mysql-connector-java并添加至类路径，解决Jenkins MySQL连接失败

问题核心 #

Jenkins插件目录下的JDBC驱动jar（mysql-connector-j-8.4.0.jar）由插件类加载器隔离管理，主脚本控制台或Pipeline的类加载器无法直接访问，因此出现"No suitable driver found"错误。

解决步骤 #

1. 确定目标路径
   将驱动jar复制到Jenkins主程序的类路径目录，推荐选择以下路径之一：

   • /usr/lib/jenkins/：与你查询到的jenkins.war同目录，Jenkins启动时会自动加载该目录下的jar包
   • 若服务器存在/var/lib/jenkins/lib/目录，也可使用此路径（这是Jenkins官方推荐的自定义库存放目录）

2. 具体操作命令

   • 先停止Jenkins服务：

     sudo systemctl stop jenkins
     

   • 复制驱动jar到目标路径：

     sudo cp /var/lib/jenkins/plugins/mysql-api/WEB-INF/lib/mysql-connector-j-8.4.0.jar /usr/lib/jenkins/
     

   • 重启Jenkins服务：

     sudo systemctl start jenkins
     

3. 验证驱动加载状态
   重启完成后，在Jenkins脚本控制台执行以下代码，若未抛出ClassNotFoundException则说明驱动加载成功：

   Class.forName("com.mysql.cj.jdbc.Driver")
   

   之后即可执行你的数据库连接代码测试连接是否正常。

注意：无需复制database-mysql.jar，该jar是插件自身的依赖文件，已由Jenkins插件机制完成加载。

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