如何通过HikariPool或Quill检查数据库及连接运行状态是否正常

HikariPool 内置连接校验能力 #

HikariCP 本身就内置了完整的连接有效性校验机制，无需额外引入第三方工具，常用配置和能力如下：

• 核心校验配置项：
  • connectionTestQuery：PostgreSQL 10.4 以下版本配置为SELECT 1即可；10.4 及以上版本建议留空，Hikari 会默认调用 JDBC4 标准的Connection.isValid()方法做校验，性能远高于自定义查询语句
  • validationTimeout：校验操作的超时时间，默认 5 秒，建议设置为短于业务接口的超时阈值
  • idleTimeout：空闲连接的最大存活时间，超过该时长的空闲连接会被自动校验，无效连接直接销毁
  • keepaliveTime：连接保活周期，定期对长时间空闲的连接做主动校验，避免被 PostgreSQL 服务端主动断开
• 运行时状态查询：Hikari 对外暴露的HikariPoolMXBean接口可以直接读取连接池实时指标，包括活跃连接数、空闲连接数、等待连接的线程堆积数等，可直接判断连接池运行状态是否正常

Quill 相关校验能力 #

Quill 作为 ORM 层框架，本身没有独立的连接校验逻辑，所有连接管理都依赖底层绑定的连接池（也就是你使用的 HikariCP），但你可以通过 Quill 上下文快速发起探测请求确认数据库服务可用：

• 最简探测方案：直接通过 Quill 运行简单的无业务侵入查询，无异常抛出即说明连接正常、数据库服务可用
• Scala 代码示例：

import io.getquill._
import com.zaxxer.hikari.HikariConfig
import com.zaxxer.hikari.HikariDataSource

// 初始化Hikari数据源和Quill上下文
val config = new HikariConfig()
config.setJdbcUrl("jdbc:postgresql://localhost:5432/你的库名")
config.setUsername("数据库用户名")
config.setPassword("数据库密码")
// 开启Hikari自动校验配置
config.setValidationTimeout(3000)
config.setKeepaliveTime(60000)

val ds = new HikariDataSource(config)
val ctx = new PostgresJdbcContext(SnakeCase, ds)

// 数据库存活性探测方法
def isDbAvailable: Boolean = {
  try {
    ctx.run(ctx.query[Unit].map(_ => 1))
    true
  } catch {
    case _: Exception => false
  }
}

补充建议 #

如果是要做服务健康检查接口，建议组合两种方案：先读取 Hikari 的 MXBean 指标判断连接池状态，再通过 Quill 发起一次简单查询确认数据库读写正常，可同时覆盖连接层和数据库服务层的校验需求。

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