Spring Boot集成测试中自定义JDBC驱动无法自动加载如何解决

现象 #

• 自定义JDBC驱动以Maven依赖形式引入项目后，主程序启动运行完全正常，可正常创建数据源
• 执行@SpringBootTest标注的集成测试时，驱动加载失败，Spring抛出dataSource Bean创建异常
• 不启动Spring上下文的纯单元测试中，驱动可正常自行注册到DriverManager
• 此前单元测试场景下无法加载src/main/resources/driver.properties的问题已修复

已确认配置 #

• 已按JDBC SPI规范，在驱动项目的src/main/resources/META-INF/services/java.sql.Driver路径下配置了服务发现文件

复现代码 #

集成测试代码 #

@SpringBootTest
public class ApplicationSmokeTest {

    @Test
    public void contextLoad(){
        assertTrue(true);
    }

}

项目Maven依赖配置 #

<dependencies>
        <dependency>
            <groupId>org.mock.jdbc</groupId>
            <artifactId>HttpDriver</artifactId>
            <version>1.0</version>
        </dependency>

        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter</artifactId>
        </dependency>

        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-test</artifactId>
            <scope>test</scope>
        </dependency>

        <dependency>
            <groupId>org.springframework</groupId>
            <artifactId>spring-test</artifactId>
            <version>5.3.3</version>
            <scope>test</scope>
        </dependency>

        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-data-jpa</artifactId>
        </dependency>
</dependencies>

解决方案 #

按优先级依次排查以下几点：

1. 手动触发驱动类加载
   DriverManager在初始化时会使用启动类加载器扫描SPI文件，测试阶段线程上下文类加载器和主程序存在差异时，会出现SPI扫描不到驱动类的问题。在测试类的静态代码块中主动用上下文类加载器加载驱动类即可触发注册逻辑：

   @SpringBootTest
   public class ApplicationSmokeTest {
       static {
           try {
               // 替换为你自定义驱动的全限定类名
               Class.forName("org.mock.jdbc.HttpDriver", true, Thread.currentThread().getContextClassLoader());
           } catch (ClassNotFoundException e) {
               throw new RuntimeException(e);
           }
       }
   
       @Test
       public void contextLoad(){
           assertTrue(true);
       }
   }
   

2. 确认测试类路径下SPI文件存在
   执行mvn test-compile后检查target/test-classes/META-INF/services/目录，确认java.sql.Driver文件存在且内容正确。如果文件缺失，要么是资源插件未正确拷贝依赖中的资源文件，可在测试资源目录src/test/resources下按相同路径补放SPI文件；要么是驱动JAR打包时未正确包含SPI文件，重新执行mvn install安装驱动即可。
3. 排除devtools类加载器干扰
   如果项目引入了spring-boot-devtools依赖，其自定义的Restart类加载器会打破JDBC驱动的SPI加载机制。两种处理方式：
   • 在测试配置中禁用devtools：spring.devtools.restart.enabled=false
   • 在测试资源目录下新增META-INF/spring-devtools.properties文件，将驱动JAR加入Restart类加载器的加载范围：

     restart.include.http-driver=/HttpDriver-.*\.jar
     

4. 校验驱动类注册逻辑
   确认自定义驱动类中存在静态注册代码块，确保类被加载时会主动向DriverManager注册实例：

   public class HttpDriver implements Driver {
       static {
           try {
               DriverManager.registerDriver(new HttpDriver());
           } catch (SQLException e) {
               throw new RuntimeException("Driver register failed", e);
           }
       }
       // 其余驱动实现逻辑
   }
   

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