Gradle构建时Spring Boot+Testcontainers遇HikariCP连接池耗尽问题

为啥只有Gradle跑测试会炸连接池？ #

• Gradle和IDEA的测试执行逻辑不一样，Gradle默认会以高并发批量执行测试，而IDEA要么串行跑，要么并行度低，同时抢连接的测试实例少，自然不会耗尽；
• Testcontainers容器复用的差异：IDEA大概率会复用同一个数据库容器，但Gradle某些配置下会为每个测试类重新启动容器，要是容器本身的连接数上限没调，或者连接池参数没跟上，就容易顶满；
• Hibernate的DDL生成拖后腿：Gradle批量跑测试时，多个测试类同时触发create-drop模式，频繁删建表会占用连接且释放不及时，进一步加剧连接紧张。

具体解决步骤 #

1. 先把Testcontainers的MySQL容器配置拉满 #

首先给MySQL容器设置足够的连接数上限，避免数据库端先扛不住：

// 在你的InitializeTestContainers类里调整容器配置
@Container
public static MySQLContainer<?> mysqlContainer = new MySQLContainer<>("mysql:8.0.37")
        .withDatabaseName("testdb")
        .withUsername("test")
        .withPassword("test")
        // 给MySQL设置最大连接数，别让数据库先卡壳
        .withCommand("--max_connections=200");

然后开启Testcontainers的容器复用，不用每次测试都启新容器：

• 要么在~/.testcontainers.properties里加一行：

  testcontainers.reuse.enable=true
  

• 要么直接在Gradle脚本里设置：

  test {
      systemProperty 'testcontainers.reuse.enable', 'true'
  }
  

2. 针对性调整HikariCP的连接池参数 #

在src/test/resources/application-test.yml里改这些参数，适配Gradle的高并发测试场景：

spring:
  datasource:
    hikari:
      maximum-pool-size: 10  # 别盲目调大，跟着并行测试数量来，比如CPU核心的一半
      minimum-idle: 2
      idle-timeout: 30000
      connection-timeout: 10000  # 缩短超时时间，别让测试死等
      leak-detection-threshold: 60000  # 延长检测阈值，避免误判泄漏
      max-lifetime: 1800000

划重点：别光调连接池大小，要是MySQL容器的max_connections没跟上，调大了反而会被数据库拒绝连接。

3. 给Gradle测试的并行度踩刹车 #

在build.gradle里明确限制并行测试的数量，避免无限制并发：

test {
    useJUnitPlatform()
    // 并行数设为CPU核心的一半，平衡测试速度和数据库压力
    maxParallelForks = Runtime.runtime.availableProcessors() / 2
    // 每个测试用独立JVM跑，避免上下文污染
    forkEvery = 1
    // 给每个测试JVM传连接池参数
    jvmArgs += "-Dspring.datasource.hikari.maximum-pool-size=10"
}

另外，给你的@DataJpaTest测试类加上@Transactional（虽然默认有，但嵌套类最好显式加），确保每个测试方法跑完就回滚事务，及时释放连接。

4. 优化Hibernate的DDL生成策略 #

频繁删建表是连接耗尽的催化剂，赶紧改：

• 把ddl-auto从create-drop改成update，只在表结构变了的时候更新，减少DDL执行：

  spring:
    jpa:
      hibernate:
        ddl-auto: update
  

• 或者用Testcontainers的初始化脚本预先建表，直接跳过Hibernate的DDL生成：

  mysqlContainer.withInitScript("schema.sql");
  

  把你的表结构脚本放到src/test/resources/schema.sql里，测试启动时一次性执行。

5. 排查潜在的连接泄漏 #

虽然你开了泄漏检测没查到，但可以试试：

• 在测试类里加个@AfterEach方法，手动检查并释放连接（如果有自定义拿连接的逻辑）：

  @Autowired
  private DataSource dataSource;
  
  @AfterEach
  void cleanUpConnections() throws SQLException {
      Connection conn = dataSource.getConnection();
      if (conn != null && !conn.isClosed()) {
          conn.close();
      }
  }
  

• 检查有没有测试方法里手动创建EntityManager没关闭，或者持有连接的逻辑没释放。

关于频繁表删建的问题 #

频繁删建表和连接池耗尽直接相关：Hibernate执行create-drop时会占着连接跑DDL，多个测试同时执行的话，连接会被长时间占用，后续测试就拿不到连接了。

测试环境的处理建议：

1. 开Testcontainers容器复用+预初始化表结构，彻底避免每次测试重建表；
2. 要是必须重建表，用@BeforeAll一次性执行DDL，别每个测试方法都跑一遍；
3. 优先用update模式，只有表结构变化时才更新，减少DDL执行次数。

内容的提问来源于stack exchange，提问作者이신지