Play Framework 2.6+PostgreSQL+JOOQ测试时出现连接数过多错误

解决Play 2.6 + JOOQ + PostgreSQL测试时连接数超限问题 #

这个连接数爆仓的问题我之前在Play框架的测试场景里也踩过坑，结合你用JOOQ和PostgreSQL的配置，咱们从核心问题入手一步步解决：

1. 先掐断重复创建连接池的根源

你提到测试前会多次创建连接池，这绝对是罪魁祸首——Play默认用HikariCP作为连接池，每个池默认会占用不少连接，多个池叠加很快就会碰PostgreSQL的100连接上限。

• 检查你的JOOQ工具类：确保DSLContext是复用Play已经初始化好的全局数据源，而不是自己每次新建连接池。比如：

  // 正确的方式：复用Play的内置数据源
  class JooqDslProvider @Inject()(db: Database) {
    val dslContext: DSLContext = DSL.using(db.dataSource, SQLDialect.POSTGRES)
  }
  

  不要在工具类里手动初始化HikariCP，Play的Database实例是单例的，依赖注入获取的数据源会全局复用，不会每次请求都新建池。

2. 优化测试环境的连接池配置

在application.conf的测试专属配置段里，把连接池的参数调小——测试场景不需要大池，小池能有效降低总连接占用：

test {
  db.default {
    hikaricp {
      maximum-pool-size = 8  // 测试场景足够用
      minimum-idle = 2
      idle-timeout = 10000   // 闲置连接快速回收
      connection-timeout = 3000
    }
  }
}

3. 控制测试的并行度与应用实例复用

如果你的测试是并行执行的，多个测试类同时启动Play应用、初始化连接池，连接数会瞬间飙升：

• 在build.sbt里关闭测试并行：

  Test / parallelExecution := false
  

• 让所有测试共享同一个Play应用实例：把基础特质从OneAppPerTest改成OneAppPerSuite，这样整个测试套件只会初始化一次连接池：

  trait BaseTestSpec extends PlaySpecification with OneAppPerSuite {
    // 所有测试共用同一个应用上下文，连接池只初始化一次
  }
  

4. 排查连接泄漏问题

确保你的仓库代码里没有连接泄漏——JOOQ的ResultQuery或者DSLContext用完要正确释放：

// 用try-with-resources模式确保连接回收
def findUserById(id: Long): Option[User] = {
  jooqDsl.withResultQuery(DSL.selectFrom(USER).where(USER.ID.eq(id))) { query =>
    query.fetchOneInto(classOf[User])
  }
}

不要手动调用dslContext.close()，因为它复用的是连接池的连接，关闭上下文会直接销毁连接池，反而导致重复创建。

5. 临时验证方案（不推荐长期用）

如果你想快速确认是不是连接池重复创建导致的，可以临时把PostgreSQL的max_connections调大到200，看看错误是否消失。但这只是临时验证，核心还是要解决连接池重复初始化的问题。

核心思路就是：避免测试过程中重复创建连接池，通过复用Play内置的单例数据源、优化测试配置、控制测试并行度这几个方向调整，很快就能解决连接数超限的问题。

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