Spring Boot中Microsoft JDBC驱动加载失败问题及疑问

问题场景 #

我维护的一个Spring Boot应用，原本通过以下代码创建SQL Server数据库连接：

SQLServerConnection sqlServerConnection = (SQLServerConnection) DriverManager.getConnection(url);

此前运行完全正常，但在更新Gradle版本及相关配置后，突然抛出驱动未找到异常。已确认连接URL正确，且生成的fat jar中确实包含SQL Server驱动包：

$ jar tf app.jar | grep jdbc
BOOT-INF/lib/mssql-jdbc-12.4.1.jre11.jar

尝试在建立连接前添加Class.forName("com.microsoft.sqlserver.jdbc.SQLServerDriver");后，问题直接解决。但根据Java 1.6+的知识，DriverManager应该能通过ServiceLoader自动发现JDBC驱动，为何现在必须手动加载？

核心原因分析 #

• Spring Boot类加载器的上下文限制：Spring Boot的fat jar使用自定义的LaunchedURLClassLoader加载BOOT-INF/lib目录下的依赖，而DriverManager的自动驱动发现逻辑依赖于系统类加载器（或当前线程上下文类加载器）能扫描到驱动包内的META-INF/services/java.sql.Driver注册文件。Gradle版本更新后，可能调整了打包时的资源处理规则，导致该注册文件无法被DriverManager的类加载器正确识别，ServiceLoader因此找不到驱动实现类。
• 手动触发驱动注册：Class.forName()会强制加载SQLServerDriver类，触发其静态代码块中的DriverManager.registerDriver(new SQLServerDriver())逻辑，直接完成驱动注册，绕开了ServiceLoader的自动发现流程。当自动发现因为类加载器问题失效时，这种手动方式就能补位解决问题。
• Gradle配置变更的连锁影响：比如更新Gradle后启用了模块化配置，或是Spring Boot Gradle Plugin版本升级改变了依赖打包的结构，导致驱动的服务注册元数据脱离了DriverManager能访问的类路径范围。

建议方案 #

手动调用Class.forName()是有效的临时 workaround，但更规范的做法是：

1. 检查Gradle打包配置，确保驱动包中的META-INF/services/java.sql.Driver文件被正确包含在可访问路径中；
2. 改用Spring Boot自带的DataSource自动配置（引入spring-boot-starter-jdbc依赖），通过Spring的连接池管理数据库连接，避免直接使用DriverManager带来的类加载兼容性问题。

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