JMeter连接SQL Server时JDBC驱动加载失败求助

问题重现 #

运行JMeter负载测试脚本时持续报错：

Cannot create JDBC driver of class 'com.microsoft.sqlserver.jdbc.SQLServerDriver' for connect URL ; java.sql.SQLException: No suitable driver
        at org.apache.commons.dbcp2.DriverFactory.createDriver(DriverFactory.java:68)
        at org.apache.commons.dbcp2.BasicDataSource.createConnectionFactory(BasicDataSource.java:459)
        at org.apache.commons.dbcp2.BasicDataSource.createDataSource(BasicDataSource.java:525)
        at org.apache.commons.dbcp2.BasicDataSource.getConnection(BasicDataSource.java:731)
        at org.apache.jmeter.protocol.jdbc.config.DataSourceElement$DataSourceComponentImpl.getConnection(DataSourceElement.java:362)
        at org.apache.jmeter.protocol.jdbc.config.DataSourceElement.getConnection(DataSourceElement.java:199)
        at org.apache.jmeter.protocol.jdbc.sampler.JDBCSampler.sample(JDBCSampler.java:81)
        at org.apache.jmeter.threads.JMeterThread.doSampling(JMeterThread.java:651) 

环境信息：

• Java版本：22.0.2
• JMeter版本：5.6.3
• 已放置mssql-jdbc-12.8.0.jre11.jar到jmeter\lib目录，并手动配置类路径，日志显示驱动已被添加到类路径：

2025-02-07 13:29:35,791 INFO o.a.j.JMeter: user.classpath=<redacted>/jmeter/lib/mssql-jdbc-12.8.0.jre11.jar
2025-02-07 13:29:35,791 INFO o.a.j.JMeter: Adding to classpath and loader: <redacted>/jmeter/lib/mssql-jdbc-12.8.0.jre11.jar

尝试过更换驱动版本（7.1、8.4）、配置类路径均无效。

解决方案 #

1. 匹配JDBC驱动与Java版本 #

你使用的mssql-jdbc-12.8.0.jre11.jar仅支持Java 11，而当前Java版本是22，版本不兼容导致驱动无法加载。

• 下载对应Java版本的驱动：选择支持Java 17+的版本（如mssql-jdbc-12.8.0.jre17.jar或mssql-jdbc-12.8.0.jre21.jar，Java 22可兼容jre21版本）
• 替换jmeter\lib目录下的旧驱动jar，重启JMeter生效

2. 检查JDBC连接URL格式 #

错误日志中connect URL ;显示URL为空或格式错误，SQL Server正确的JDBC URL格式示例：

jdbc:sqlserver://your-server-name:1433;databaseName=your-db-name;encrypt=true;trustServerCertificate=true;

确保URL包含服务器地址、端口、数据库名称及必要参数（如加密配置），无语法错误（如多余分号或缺失参数）

3. 验证驱动加载状态 #

添加JSR223 Sampler，执行以下Groovy代码验证驱动是否能被加载：

try {
    Class.forName("com.microsoft.sqlserver.jdbc.SQLServerDriver")
    log.info("✅ SQL Server Driver loaded successfully")
} catch (ClassNotFoundException e) {
    log.error("❌ Failed to load SQL Server Driver: " + e.getMessage())
}

运行后查看jmeter.log：

• 若显示加载成功：问题出在连接配置（URL、用户名/密码错误）
• 若加载失败：检查驱动jar是否正确放置、版本是否兼容，确保JMeter已重启

4. 移除手动类路径配置 #

JMeter会自动扫描jmeter\lib目录下的jar包，手动在jmeter.properties或user.properties中配置类路径可能导致类加载冲突。删除这些手动配置的user.classpath或system.classpath条目，重启JMeter

5. 对齐JMeter与Java版本兼容性 #

JMeter 5.6.3官方推荐Java版本为8~21，使用Java 22可能存在潜在兼容性问题。若上述方案无效，可降级Java至21 LTS版本，再配合对应版本的JDBC驱动测试

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