如何排查MySQL迁移后应用程序出现的连接池超时-mysql教程-PHP中文网

连接池超时本质是应用无法获取空闲连接，而非数据库不可达；需优先检查hikaricp active连接数、leak-detection-threshold配置、异步/事务中连接泄漏，并确保idle-timeout ≤ wait_timeout ≤ max-lifetime对齐。

如何排查mysql迁移后应用程序出现的连接池超时

连接池超时不是数据库连不上，而是应用拿不到连接

迁移后报 Connection is not available, request timed out after 30000ms 或类似日志，90% 的情况不是 MySQL 没启动、端口不通，而是应用侧连接池里没空闲连接可分配。此时 SHOW STATUS LIKE 'Threads_connected'; 可能只显示几十个连接，但 HikariCP 的 active 指标已打满——说明连接被借出后没归还，或归还路径异常阻塞。

实操建议：

先查应用端真实活跃连接数：通过 JMX 查 HikariPool-1.active（或对应池名），比 MySQL 的 Threads_connected 更准；
确认是否真卡在“获取连接”环节：在应用日志中搜 connection-timeout 和 waiting for available connection，而非只看 SQL 报错；
别急着调大 maximum-pool-size：扩容只是掩盖泄漏，可能引发下游 MySQL max_connections 超限或内存耗尽。

迁移后泄漏暴露得更明显，因为响应变慢 + wait_timeout 延长

旧环境响应快，泄漏连接可能几秒内就归还；新环境因网络跳转、代理层、或 DNS 解析延迟，SQL 执行或事务提交变慢，原本“勉强不漏”的代码路径，在迁移后直接暴露为连接卡住。同时若你顺手把 wait_timeout 从 300 秒调到 28800 秒（想防中断），等于给泄漏连接续了命——它们在池外挂着不动，池内又不断新建，最终耗尽。

实操建议：

检查 leak-detection-threshold 是否启用且设合理：推荐 120000–300000（2–5 分钟），并确保 com.zaxxer.hikari 日志级别为 WARN；
重点扫描异步/回调场景：CompletableFuture 分支、@Transactional 内手动 getConnection()、流式处理中 try-with-resources 被异常提前中断；
对比迁移前后 SHOW PROCESSLIST 中相同 user 的 Sleep 连接数量和 time 值：若迁移后 time 稳定在 600+ 秒且持续增长，基本锁定泄漏。

连接池配置与 MySQL 超时参数必须对齐，否则互相打架

常见错误是只改一边：比如把 HikariCP 的 idle-timeout 设成 600000（10 分钟），但 MySQL 的 wait_timeout 还是默认 28800（8 小时）。结果连接在池里空闲 10 分钟后被池主动驱逐，但 MySQL 那边还认为它活着，下次复用时抛 Connection reset 或静默失败；反过来，若 wait_timeout 设太短（如 60 秒），而池没配 validation-timeout 和 connection-test-query，就会频繁拿到失效连接。

MySQL

编写正确的MySQL查询，避免字符集、索引和锁方面的常见陷阱。

下载

实操建议：

三参数必须对齐：idle-timeout（池） ≤ wait_timeout（MySQL） ≤ max-lifetime（池），推荐值均为 300–600 秒；
MySQL 端修改必须写入 my.cnf 的 [mysqld] 段并重启，SET GLOBAL 仅临时生效；
HikariCP 必须配 connection-test-query=SELECT 1 和 validation-timeout=3000，否则空闲连接回收后无法及时探测有效性。

别忽略代理层和驱动升级带来的隐性变化

迁移常伴随引入 ProxySQL、Cloud SQL 代理、或升级 MySQL 驱动（如从 5.1.x 到 8.0.x）。这些组件会修改连接元数据：ProxySQL 可能隐藏真实客户端 IP，导致 processlist.host 全是 127.0.0.1，无法按来源过滤；驱动升级后默认开启 cachePrepStmts=true 和 useServerPrepStmts=true，若应用未适配，prepare 阶段异常可能跳过 close 流程。

实操建议：

在 SHOW PROCESSLIST 中观察 host 字段是否异常统一（如全为代理 IP），此时需结合 information_schema.processlist 的 program_name 或应用埋点日志定位真实来源；
检查驱动版本兼容性：MySQL 8.0+ 必须用 mysql-connector-java:8.0.x，且连接 URL 加 allowPublicKeyRetrieval=true&serverTimezone=UTC；
若用了健康检查（如 Spring Boot Actuator 的 jdbc endpoint），确认其调用频率是否过高——高频 SELECT 1 可能占满连接池的最小空闲连接。