Jenkins执行JMeter非GUI模式时出现JDBC连接建立失败错误

你在Jenkins中以非GUI模式运行JMeter脚本时遇到的这个错误，核心是JMeter无法和数据库建立网络连接，导致连接池创建失败。我帮你梳理几个最常见的排查和解决方向：

• 先确认Jenkins服务器能连通数据库
  第一步先排除网络问题：在Jenkins所在的服务器上，尝试ping数据库的主机地址，如果ping不通，说明网络链路有问题（比如防火墙拦截、主机名解析错误）。再用telnet测试数据库端口是否开放，比如Oracle常用1521端口，命令如下：

  telnet your-db-server-ip 1521
  

  如果telnet连接失败，先找运维团队打通网络或者开放对应端口。

• 核对JDBC连接配置的细节
  检查JMeter里的JDBC Connection Configuration元件：

  • 确认Database URL格式完全正确，比如Oracle的URL应该是jdbc:oracle:thin:@//db-host:port/service-name，MySQL是jdbc:mysql://db-host:port/db-name?useSSL=false&serverTimezone=UTC，别写错主机、端口、服务名/数据库名。
  • 检查JDBC Driver class是否匹配数据库类型，比如MySQL 8.x要用com.mysql.cj.jdbc.Driver，而不是旧版的com.mysql.jdbc.Driver。
  • 确认数据库用户名和密码没有拼写错误，且该账号拥有连接数据库的权限。

• 确保JDBC驱动包正确且可被加载
  JMeter依赖对应的数据库JDBC驱动包才能连接数据库：

  • 驱动包版本要和数据库版本兼容，比如Oracle 19c的驱动不要用来连Oracle 11g。
  • 把驱动包放到JMeter安装目录的lib文件夹下，确保Jenkins运行JMeter时能加载到这个驱动（不要随便放在自定义路径，避免加载失败）。

• 排查Jenkins环境的网络代理设置
  如果Jenkins服务器配置了全局网络代理，可能会影响到内部数据库的连接。可以去Jenkins的「系统管理」→「系统配置」里查看代理设置，若数据库是内部服务，需要将数据库地址加入代理的例外列表。

• 对比GUI与非GUI模式的环境差异
  如果本地GUI模式能正常运行脚本，那问题大概率出在Jenkins服务器的环境上：

  • 检查Jenkins使用的Java版本和本地是否一致，部分JDBC驱动对Java版本有要求（比如MySQL 8.x驱动需要Java 8及以上）。
  • 确认Jenkins服务器的系统环境变量没有影响网络连接的配置。

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