基于Hibernate+DB2+Spring的应用执行任务时出现JDBCConnectionException报错

异常信息 #

嵌套异常为 org.hibernate.exception.JDBCConnectionException: 无法执行查询
（原英文异常：nested exception is org.hibernate.exception.JDBCConnectionException: could not execute query）

排查解决步骤 #

1. 连接池配置校验 #

• 确认你使用的连接池（默认HikariCP）的maximum-pool-size参数值小于DB2服务端配置的最大允许连接数，避免连接被DB2主动拒绝。
• 调整连接池idle-timeout参数，确保其值小于DB2服务端的CONNECT_TIMEOUT、MAX_IDLE参数值，避免应用拿到已经被DB2关闭的僵死连接。
• 增加连接有效性检测配置，HikariCP对应配置为spring.datasource.hikari.connection-test-query=VALUES 1，每次获取连接前先执行测试SQL验证连接可用。

2. Hibernate配置校验 #

• 确认hibernate.connection.isolation事务隔离级别配置和DB2服务端配置匹配，DB2默认隔离级别为读稳定性（RS），配置不匹配会引发连接握手失败。
• 检查是否配置了错误的DB2方言，正确配置应为hibernate.dialect=org.hibernate.dialect.DB2Dialect，可根据你使用的DB2版本选择对应方言实现。

3. 网络与DB2服务端排查 #

• 排查应用服务器到DB2服务端的网络链路，确认防火墙、安全组没有设置空闲连接自动断开的规则，多数云环境默认300秒无流量的空闲连接会被主动切断。
• 查看DB2服务端诊断日志db2diag.log，确认是否存在连接数超限、权限校验失败、实例CPU/内存资源不足的相关报错。

4. 连接泄漏定位 #

• 如果应用重启后故障临时恢复，运行一段时间后再次报错，基本可以判定为连接泄漏：
  • 重点排查未添加@Transactional注解的数据库操作，确认Session/Connection使用后正常关闭。
  • 排查是否存在大事务长时间持有连接不释放的场景，避免长事务占用连接池资源导致新请求无法获取连接。

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