Jenkins共享库无法找到SQL驱动问题求助

我来帮你梳理这个问题的常见原因和解决办法，结合你的代码和Jenkins的运行机制，逐个排查：

1. Jenkins脚本安全策略限制了@Grab的使用 #

Jenkins的脚本安全沙箱默认会阻止动态拉取外部依赖的操作，@Grab注解需要从Maven仓库下载jar包，很可能被安全策略拦截了。

• 解决步骤：
  • 进入Manage Jenkins > In-process Script Approval，查看是否有等待批准的@Grab相关签名或权限请求，批准它们。
  • 如果频繁出现这类问题，可以考虑在Jenkins全局安全配置中，调整Groovy沙箱的权限设置（不建议完全关闭沙箱，按需添加权限即可）。

2. @Grab下载的依赖不在Jenkins类加载器的访问路径中 #

@Grab默认会把依赖下载到运行用户的~/.grab目录下，但Jenkins的运行用户（比如jenkins系统用户）可能和你开发时的用户不同，或者Jenkins的类加载器没有包含这个路径，导致找不到驱动jar。

• 解决办法：
  • 手动添加驱动到Jenkins全局类路径：下载mssql-jdbc-6.4.0.jre8.jar，放到Jenkins安装目录的WEB-INF/lib文件夹下，然后重启Jenkins。这样全局类加载器会自动加载这个驱动，不需要依赖@Grab。
  • 指定@Grab的解析器和存储路径：在@Grab注解旁添加解析器，确保从可靠仓库拉取，同时可以指定存储路径到Jenkins可访问的位置：

    @GrabResolver(name='mavenCentral', root='https://repo1.maven.org/maven2/')
    @Grab(group='com.microsoft.sqlserver', module='mssql-jdbc', version='6.4.0.jre8')
    

3. 共享库类加载顺序导致驱动无法被加载 #

Jenkins共享库的类加载器有特定的优先级，可能@Grab加载的依赖时机晚于类初始化，导致找不到驱动。

• 解决尝试：
  • 在类的构造函数中手动触发驱动加载，确保类加载时驱动已就绪：

    MySQLClass(databaseConfig) {
        // 设置相关实例变量...
        Class.forName("com.microsoft.sqlserver.jdbc.SQLServerDriver")
        dbconnection = Sql.newInstance(dbURL, dbUsername, dbPassword, dbDriver)
    }
    

  • 确认你的dbDriver变量设置的是正确的驱动类名：com.microsoft.sqlserver.jdbc.SQLServerDriver。

4. 依赖版本与Jenkins运行环境不兼容 #

你使用的6.4.0.jre8版本是针对JRE8的，如果Jenkins运行的是更高版本的JDK（比如JRE11或17），这个驱动版本可能存在兼容性问题，导致无法加载。

• 解决办法：
  • 查看Jenkins的JDK版本（Manage Jenkins > System Information中找java.version），更换对应兼容的驱动版本，比如：
    • JRE8：可以用9.4.0.jre8
    • JRE11：用12.4.0.jre11
    • JRE17：用12.4.0.jre17

验证步骤 #

先在本地Groovy环境中测试你的代码，确认驱动能正常加载：

@Grab(group='com.microsoft.sqlserver', module='mssql-jdbc', version='6.4.0.jre8')
import com.microsoft.sqlserver.jdbc.SQLServerDriver
import groovy.sql.Sql

def config = [url: "jdbc:sqlserver://your-db:1433;databaseName=test", username: "user", password: "pass", driver: "com.microsoft.sqlserver.jdbc.SQLServerDriver"]
def sql = Sql.newInstance(config.url, config.username, config.password, config.driver)
println "Connected successfully!"
sql.close()

如果本地能正常运行，说明问题出在Jenkins的配置或类加载上，再回到上面的步骤排查。

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