JHipster生成的SpringBoot项目二次启动报Hikari SQLSTATE(08003)错误

问题现象 #

• 基于JHipster 7.8.1生成的SpringBoot 2.6.6项目，在Ubuntu系统中连接PostgreSQL 14.9，首次启动连接正常
• 二次启动时触发错误：JPA EntityManagerFactory初始化失败，Hikari连接池标记连接损坏，错误提示包含SQLSTATE(08003)、连接已关闭
• 尝试通过Ctrl+C终止应用、调用actuator/shutdown接口停止应用，后续启动仍报错
• 重建数据库并重启PostgreSQL服务后，首次启动恢复正常，但二次启动依旧出现相同问题

原配置 #

datasource:
    type: com.zaxxer.hikari.HikariDataSource
    url: jdbc:postgresql://localhost:5432/XXXX
    username: XXXX
    password: XXXX
    hikari:
      poolName: Hikari
      auto-commit: false
      connectionTestQuery: SELECT 1
      testWhileIdle: true
      timeBetweenEvictionRunsMillis: 60000
      idleTimeout : 600000
      validationTimeout : 300000
      connectionTimeout: 30000
      maxLifetime : 1800000      
    removeAbandoned : true
    removeAbandonedTimeout : 60

解决方案 #

1. 修正Hikari参数适配PostgreSQL #

PostgreSQL默认的连接超时配置与Hikari参数存在不匹配，导致连接被数据库主动关闭后，连接池未及时清理无效连接：

• 将maxLifetime调整为小于PostgreSQL默认的wal_sender_timeout（60000ms），建议设为540000ms（9分钟），避免连接在池内过期
• 启用testOnBorrow，确保获取连接时立即验证有效性，补充testWhileIdle的定时检测不足
• 移除connectionTestQuery，PostgreSQL驱动支持JDBC4标准的isValid()方法，Hikari会自动调用，无需手动指定查询语句
• 降低validationTimeout至30000ms，快速检测连接有效性，避免等待超时

2. 修正配置层级错误 #

原配置中removeAbandoned和removeAbandonedTimeout是Tomcat连接池的参数，Hikari对应的参数为leakDetectionThreshold，需移至hikari节点下，用于检测连接泄露，建议设置为60000ms（1分钟）

3. 优化应用关闭逻辑 #

• 确保应用关闭时所有事务均已提交或回滚，避免连接未被正确归还到连接池
• 启用registerMbeans参数，方便通过JMX监控连接池状态，排查连接泄露问题

修正后配置示例 #

datasource:
    type: com.zaxxer.hikari.HikariDataSource
    url: jdbc:postgresql://localhost:5432/XXXX
    username: XXXX
    password: XXXX
    hikari:
      poolName: Hikari
      auto-commit: false
      testOnBorrow: true
      testWhileIdle: true
      timeBetweenEvictionRunsMillis: 60000
      idleTimeout: 600000
      validationTimeout: 30000
      connectionTimeout: 30000
      maxLifetime: 540000
      leakDetectionThreshold: 60000
      registerMbeans: true

内容的提问来源于stack exchange，提问作者Ranjith Raj D