使用HikariCP对接Postgres时如何检测数据库宕机避免等待客户端超时

可以通过HikariCP自带配置 + 应用层容错组合的方式实现快速失败，完全避免无意义的checkoutTimeout等待：

• 优先使用JDBC4原生连接检测：Java 11配合PostgreSQL 42.2+版本的JDBC驱动已支持Connection.isValid()原生方法，无需配置connectionTestQuery，只需将validationTimeout设置为1000~2000毫秒（默认5000毫秒），连接出池前的健康检测最多等待该时长就会判定连接是否失效，远短于常规的checkoutTimeout配置。
• 避免使用废弃的检测配置：不要使用低版本常用的SELECT 1作为检测语句，原生isValid()的检测效率和准确性更高。

• 调整maxLifetime参数：设置为比PostgreSQL端的idle_in_transaction_session_timeout、tcp_keepalives_idle等超时配置短30秒以上，例如数据库端空闲连接超时为30分钟，可将maxLifetime设为1740000毫秒（29分钟），HikariCP会主动淘汰过期连接，避免池内留存数据库端已经断开的死连接。
• 启用keepaliveTime参数：设置为300000_{600000毫秒（5}10分钟），HikariCP会对空闲连接主动发送检测包保活，提前识别宕机的数据库节点，第一时间清理池内无效连接。

在PostgreSQL连接串中添加网络层超时参数，避免底层TCP握手/数据传输无限制等待：

jdbc:postgresql://<host>:<port>/<dbname>?connectTimeout=2&socketTimeout=5

上述配置中connectTimeout为TCP连接建立的最大超时时间（单位秒），socketTimeout为查询执行后等待数据库返回的最大超时时间，即使健康检测漏过了死连接，最多等待5秒就会返回失败，不会卡住业务线程。

引入Resilience4j、Sentinel等容错组件配置断路器规则，当单位时间内数据库调用失败率达到阈值（例如10秒内5次调用失败），断路器直接打开，后续所有发往该数据库的请求直接返回失败，无需再走连接池申请逻辑，直到数据库恢复后再自动半开试探流量。

# HikariCP核心配置
spring.datasource.hikari.connection-timeout=3000
spring.datasource.hikari.validation-timeout=1000
spring.datasource.hikari.max-lifetime=1740000
spring.datasource.hikari.keepalive-time=300000
# Postgres JDBC连接配置
spring.datasource.url=jdbc:postgresql://127.0.0.1:5432/test_db?connectTimeout=2&socketTimeout=5
spring.datasource.username=postgres
spring.datasource.password=postgres

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