Spring Boot使用Hikari连接PostgreSQL报连接已关闭，调整参数后告警仍存在如何解决？

你遗漏的核心配置点 #

• PostgreSQL 除了idle_in_transaction_session_timeout之外，还有idle_session_timeout参数，控制非事务状态下的空闲会话超时，很多场景下该参数被运维或云厂商默认设置为小于15分钟的数值，导致你的Hikari max-lifetime（900000ms即15分钟）实际超过了数据库空闲会话阈值
• 未配置Hikari的连接存活检测相关参数，无法在连接被上游断开前主动清理无效连接
• 未考虑中间层（防火墙、负载均衡、云数据库网关）的TCP空闲超时，大部分网络组件会主动断开超过阈值的空闲TCP连接，该超时时间通常小于数据库侧的会话超时

具体操作步骤 #

步骤1：确认数据库侧所有超时参数 #

执行SQL查询所有空闲相关超时配置：

select name, setting, unit from pg_settings where name like '%idle%timeout%';

根据返回结果调整，保证Hikari的max-lifetime比所有数据库侧空闲超时参数都小至少30秒。如果是云数据库，还要额外确认云平台默认的连接超时配置。

步骤2：补充完整Hikari连接池配置 #

在application.properties中更新如下配置（可根据你的实际上游超时调整数值）：

# 连接有效性检测语句，PostgreSQL通用检测语句
spring.datasource.hikari.connection-test-query=SELECT 1
# 连接检测超时时间，单位毫秒，最大不超过5秒
spring.datasource.hikari.validation-timeout=3000
# 空闲连接定期检测时间，单位毫秒，建议设为上游最小超时的1/2
spring.datasource.hikari.keepalive-time=300000
# 连接最大生命周期，单位毫秒，必须比所有上游（数据库、中间层）的最小超时小至少30秒
# 示例中假设上游最小超时为10分钟，此处设为9分30秒
spring.datasource.hikari.max-lifetime=570000
# 借出连接时检测有效性，避免把无效连接给到业务
spring.datasource.hikari.test-on-borrow=true

步骤3：排查中间层网络超时 #

如果服务和数据库之间有防火墙、Nginx、负载均衡、云网关等组件，确认组件的TCP空闲超时时间，将Hikari的max-lifetime设置为比该值小至少30秒。

步骤4：重启应用生效 #

配置更新后重启Spring Boot应用，重建Hikari连接池即可消除告警。

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