升级Spring Boot 2.6.6后MSSQL数据库连接异常问题咨询

API 探路者

2026-8-29

问题背景

生产环境升级至Spring Boot 2.6.6版本后，持续出现MSSQL数据库连接类故障，核心报错信息：

com.microsoft.sqlserver.jdbc.SQLServerException: The query has timed out. The query has timed out.
connection is broken
当前环境组件版本：
MSSQL JDBC驱动：5.3.18
MSSQL R2DBC驱动：1.1.7

排查解决思路

该问题属于Spring Boot 2.6.x版本升级后MSSQL驱动与内置连接池适配的典型问题，社区有大量同类反馈，可按以下优先级逐一排查：

优先解决驱动版本不兼容问题
Spring Boot 2.6.6默认内置的HikariCP版本为4.0.x、r2dbc-pool版本为0.9.x，两个连接池版本都对连接有效性校验、空闲连接回收逻辑做了调整。当前使用的mssql-jdbc 5.3.18是2017年发布的老旧版本，对JDBC4.0规范要求的Connection.isValid()接口实现存在已知缺陷：当连接被服务端或网络链路静默切断时，驱动无法正确识别连接状态，会直接复用失效连接发起请求，随机触发connection is broken报错，失效连接的重试逻辑还会误触发查询超时。配套的mssql-r2dbc 1.1.7版本同样存在心跳检测逻辑和新连接池不兼容的问题。
验证方式：直接将mssql-jdbc升级至8.4.1及以上LTS版本，mssql-r2dbc升级至和Spring Boot 2.6.x匹配的0.9.2.RELEASE版本，重启服务观察报错是否消失，绝大多数同类场景升级驱动后问题直接解决。
显式调整连接池配置，规避默认值不匹配
Spring Boot 2.6.x对连接池的默认参数做了调整，其中HikariCP默认maxLifetime为30分钟、validationTimeout为250ms，而大部分生产环境中MSSQL服务端默认空闲连接超时为10分钟，中间链路的防火墙、负载均衡的会话超时通常在5-15分钟，连接池持有连接的时间超过链路超时阈值后，连接会被静默切断，连接池未及时剔除就会把失效连接分给业务请求。
建议在配置文件中显式指定连接池参数，不要依赖默认值，参考配置如下：

spring:
  datasource:
    hikari:
      # 配置值比数据库/链路侧的空闲连接超时短1-2分钟，保证连接在被切断前被连接池主动回收
      max-lifetime: 480000
      validation-timeout: 5000
      # 兼容老驱动场景可显式指定检测SQL，绕开isValid()接口的实现bug
      connection-test-query: SELECT 1
      connection-timeout: 30000
  r2dbc:
    pool:
      max-idle-time: 480000
      validation-query: SELECT 1

排查链路与服务端侧的断连原因
如果升级驱动、调整配置后仍偶发报错，需要同步检查两端日志：在MSSQL服务端查看系统日志，确认是否存在内存不足、连接数打满主动踢掉连接的情况；同时检查应用到数据库之间的网络链路，确认安全组、防火墙、负载均衡是否存在长连接会话超时强制切断的策略。这类链路问题在低版本Spring Boot中可能因为连接复用率低没有暴露，升级后连接池效率提升、连接持有时间变长，就会把隐性问题触发出来。
专项排查查询超时问题
如果报错集中在特定SQL语句上，需要注意Spring Boot 2.6.x为JdbcTemplate、R2dbcTemplate新增了默认查询超时配置，之前无超时限制的慢SQL在升级后会直接触发超时，可针对对应SQL单独调大超时阈值，或者直接优化慢查询逻辑。

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