Groovy配置@Grab引入mssql-jdbc仍提示找不到合适JDBC驱动

1. JDBC4.0自动加载驱动的机制限制 #

JDBC4.0及以上版本的自动驱动加载基于Java SPI（服务提供接口）实现，触发逻辑有严格的时序要求：

• java.sql.DriverManager类首次被JVM加载时，会扫描当前所有可访问类路径下JAR包的META-INF/services/java.sql.Driver文件，自动加载并注册文件中声明的驱动类
• 这个SPI扫描只会执行一次，后续动态添加到类路径的驱动包，不会被DriverManager自动识别

2. Groovy Grape的加载时序冲突 #

问题本质是Grape加载驱动的时机晚于DriverManager的SPI扫描时机：

• Groovy脚本启动时，会先初始化核心类加载器、加载JDK核心类（包含java.sql.DriverManager），此时Grape还没处理@Grab注解，驱动JAR不在类路径中，DriverManager的首次扫描不会识别到SQL Server驱动
• 后续Grape完成驱动下载、并按照@GrabConfig(systemClassLoader=true)的配置把驱动添加到系统类加载器路径时，已经错过了DriverManager的自动扫描时机，因此驱动没有被注册到管理器中

3. 手动加载驱动生效的原因 #

com.microsoft.sqlserver.jdbc.SQLServerDriver类内部存在静态代码块，类被加载时会自动执行注册逻辑：

static {
    DriverManager.registerDriver(new SQLServerDriver());
}

手动调用Class.forName("com.microsoft.sqlserver.jdbc.SQLServerDriver")时，会主动触发驱动类的加载，让驱动完成向DriverManager的注册，后续就能正常匹配jdbc:sqlserver开头的连接URL。

可选解决方法 #

• 保持现有方案，创建连接前手动加载驱动类，改动最小兼容性高
• 若要使用自动加载能力，可将对应版本的mssql-jdbc JAR包放到Groovy安装目录的lib子目录下，驱动会在Groovy启动时提前加载到类路径，赶在DriverManager首次SPI扫描前完成注册

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