必须让连接池max-lifetime严格小于wait_timeout并配合有效性验证,否则仍会复用已断连接;需实查当前生效的wait_timeout和interactive_timeout值,二者须统一设置,HikariCP中max-lifetime应比wait_timeout小至少30秒,禁用autoReconnect=true,改用保活机制与连接探测。

这个问题基本不是“连接失败”,而是“连接被服务器主动断开后,程序还拿它继续用”——绝大多数情况是连接池里混进了失效连接,业务线程取到后一执行 SQL 就崩。
MySQL 的 wait_timeout 是罪魁祸首
MySQL 默认 wait_timeout=28800(8 小时),但很多生产环境会调小到 30 分钟甚至更短。只要连接空闲超过这个时间,MySQL 服务端就会单方面关闭 TCP 连接,而你的连接池并不知道。
此时连接池仍把它当“活连接”返回给业务代码,一执行 executeQuery() 或 setString() 就触发 CommunicationsException,报错里那句 “The last packet sent successfully to the server was XXX milliseconds ago” 就是铁证。
- 查当前值:
SHOW VARIABLES LIKE 'wait_timeout'; - 临时改大(重启失效):
SET GLOBAL wait_timeout = 86400; - 永久生效:在
my.cnf的[mysqld]段加wait_timeout = 86400,然后重启 MySQL
JDBC URL 必加的三个参数
光调大 wait_timeout 不够,连接池和驱动必须配合检测和清理失效连接。JDBC URL 至少补上这三项:
-
useSSL=false:除非真用 SSL,否则默认开启会因证书问题静默失败 -
serverTimezone=Asia/Shanghai:MySQL 8+ 必须显式指定,否则连接可能卡住或报时区异常 -
socketTimeout=30000:避免网络抖动时卡死,超时后抛明确异常而非无限 hang
完整示例:jdbc:mysql://127.0.0.1:3306/mydb?useSSL=false&serverTimezone=Asia/Shanghai&socketTimeout=30000
注意:autoReconnect=true 在新版驱动(mysql-connector-java 8.0+)中已被废弃,且不解决根本问题,别再用了。
安装、修复、更新或打包一个基于 Python 和 PyMySQL 实现的 Windows `mysql` 命令。适用于用户希望在 PowerShell/CMD 中输入 `mysql` 时重定向到 Python 实现、需要交互式输入 MySQL 连接信息、需要同步到当前用户本地 bin 目录,或需要将该能力封装成可公开复用的 Codex skill。
Druid 连接池必须配的三项检查
如果你用的是 Druid(常见于 Spring Boot 项目),仅靠 JDBC URL 不足以拦截“已断开但未被发现”的连接。必须显式启用连接有效性校验:
-
testWhileIdle=true:空闲时主动 ping,提前剔除死连接 -
validationQuery=SELECT 1:校验 SQL,MySQL 下必须是无副作用的简单语句 -
timeBetweenEvictionRunsMillis=30000:每 30 秒扫一次空闲连接(建议 ≤wait_timeout / 2)
漏掉其中任意一项,连接池就大概率把“断了但没被发现”的连接交给你,报错只是时间问题。
localhost 和 127.0.0.1 真的不一样
在 Linux/macOS 上,localhost 会走 Unix socket 文件(如 /var/run/mysqld/mysqld.sock),而 127.0.0.1 才走 TCP。如果 MySQL 配置了 skip-networking 或 bind-address = 127.0.0.1,用 localhost 可能连不上或行为异常。
排查时直接换掉:jdbc:mysql://127.0.0.1:3306/xxx —— 统一走 TCP,排除 socket 层干扰。
真正难缠的点不在配置本身,而在于“连接失效”和“连接池感知失效”之间存在时间差。这个窗口期越长,业务拿到死连接的概率越高。所以关键不是让连接永不超时,而是让连接池比 MySQL 更早、更勤地发现它已经死了。










