HikariCP连接超时异常：设置30秒超时却提前触发错误

环境信息 #

• JDK: 18
• 数据库：PostgreSQL (42.3.5)
• HikariCP: 4.0.3
• Spring Boot: v2.7.0

问题现象 #

已将connectionTimeout设置为30秒，但请求未等到超时时长就提前抛出「Connection is not available, request timed out」错误。

日志时间线 #

• 20:55:46 - 等待连接数为0
• 20:55:47 - 10个连接处于活跃状态，另有10个等待连接
• 20:55:53 - 10个活跃连接，20个等待连接
• 20:55:53 - 抛出连接超时错误

备注：并非连接泄漏问题，活跃连接未冻结。

技术栈与配置 #

技术栈：Spring Data JPA + Hibernate + JDBC

spring.datasource.url=jdbc:postgresql://....
spring.jpa.hibernate.ddl-auto=none
spring.jpa.properties.hibernate.jdbc.lob.non_contextual_creation=true
spring.jpa.properties.hibernate.dialect=org.hibernate.dialect.PostgreSQLDialect

HikariCP详细配置指标 #

HikariConfig | HikariPool-1 - configuration:
HikariConfig | allowPoolSuspension................................false
HikariConfig | autoCommit................................true
HikariConfig | catalog................................none
HikariConfig | connectionInitSql................................none
HikariConfig | connectionTestQuery................................none
HikariConfig | connectionTimeout................................30000
HikariConfig | dataSource................................none
HikariConfig | dataSourceClassName................................none
HikariConfig | dataSourceJNDI................................none
HikariConfig | dataSourceProperties................................
HikariConfig | driverClassName................................"org.postgresql.Driver"
HikariConfig | exceptionOverrideClassName................................none
HikariConfig | healthCheckProperties................................{}
HikariConfig | healthCheckRegistry................................none
HikariConfig | idleTimeout................................600000
HikariConfig | initializationFailTimeout................................1
HikariConfig | isolateInternalQueries................................false
HikariConfig | keepaliveTime................................0
HikariConfig | leakDetectionThreshold................................30000
HikariConfig | maxLifetime................................1800000
HikariConfig | maximumPoolSize................................10
HikariConfig | metricRegistry................................none
HikariConfig | minimumIdle................................10
HikariConfig | password................................
HikariConfig | poolName................................"HikariPool-1"
HikariConfig | readOnly................................false
HikariConfig | registerMbeans................................false
HikariConfig | scheduledExecutor................................none
HikariConfig | schema................................none
HikariConfig | threadFactory................................internal
HikariConfig | transactionIsolation................................default
HikariConfig | username................................"postgres"
HikariConfig | validationTimeout................................5000

排查与解决建议 #

1. 修正validationTimeout配置冲突
   当前validationTimeout设为5000ms（5秒），远小于connectionTimeout。Hikari验证连接时若超时会丢弃连接并重新尝试，多次验证失败会快速消耗等待窗口，导致提前触发超时。建议将validationTimeout调整为不小于connectionTimeout的1/2，比如15000ms。

2. 扩容连接池容量
   当前maximumPoolSize仅为10，短时间内等待连接数达到20，说明池容量无法应对峰值请求。可根据数据库承载能力调大maximumPoolSize（如20-30），同时将minimumIdle设为略低于最大值，避免闲置资源浪费。

3. 检查数据库连接上限
   确认PostgreSQL的max_connections参数值，若数据库允许的总连接数小于Hikari池大小+其他应用连接数，会导致Hikari无法创建新连接，提前触发超时。

4. 优化业务查询性能
   活跃连接长期占用，说明查询耗时过长导致连接无法及时释放。需排查慢查询，优化SQL语句、添加索引，缩短连接占用时间。

5. 调整leakDetectionThreshold
   当前该阈值与connectionTimeout均为30秒，可能引发误判。建议将其设为大于connectionTimeout的值（如60秒），避免干扰正常的连接超时逻辑。

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