symfony 不主动断开数据库连接,真正原因包括:mysql wait_timeout 触发自动关闭、pdo 持久连接误用、database_url 中 localhost 导致 unix socket 错误、特殊字符未 url 编码、serverversion 不匹配、连接泄漏导致 max_connections 溢出。

Symfony 本身不主动“断开”数据库连接——连接中断是底层 PDO 或 MySQL 层面的行为,Symfony 只是暴露了它。真正导致连接断开的,通常是配置、环境或使用方式上的隐性冲突。
MySQL wait_timeout 触发连接自动关闭
这是最常见原因:MySQL 服务端默认 wait_timeout 是 28800 秒(8 小时),但很多云数据库或 Docker 镜像会设得更激进(比如 300 秒)。PHP 请求结束时,PDO 持久连接不会真正 close,而是留在进程里等待复用;如果下次复用前 MySQL 已 kill 掉该连接,就会报 MySQL server has gone away。
- 查当前值:
SHOW VARIABLES LIKE 'wait_timeout'; - 临时调高(需 SUPER 权限):
SET GLOBAL wait_timeout = 28800; - 生产环境建议在 MySQL 配置文件中持久设置,并与 PHP-FPM
pm.max_children和pm.max_requests协同调整
PDO 持久连接(PDO::ATTR_PERSISTENT)被误用
Doctrine 默认不启用持久连接,但如果你在自定义 PDO 实例或第三方包里手动加了 PDO::ATTR_PERSISTENT => true,就可能踩坑:Apache prefork 模式下每个子进程缓存独立连接,而连接状态(如事务、临时表、字符集)不会重置,下次复用时直接继承脏状态,MySQL 可能拒绝执行或静默失败。
- Doctrine 官方明确不推荐在 Web 场景下开启持久连接
- 若真要用,必须确保每次请求开始前显式
$conn->beginTransaction()/$conn->rollBack()清理上下文 - 更稳妥的做法是关掉它,靠连接池中间件(如 ProxySQL)统一管理
DATABASE_URL 中 host 写成 localhost 导致 Unix socket 路径错乱
在 Linux 云服务器或 Docker 环境里,localhost 不等于 127.0.0.1。MySQL 客户端看到 localhost 会强制走 Unix socket(如 /var/run/mysqld/mysqld.sock),但容器内往往没有这个路径,或权限不对,结果报 SQLSTATE[HY000] [2002] No such file or directory——看起来像连接断开,其实是根本连不上。
- 一律改用
127.0.0.1(IPv4 显式走 TCP)或内网 DNS 名(如mysql.internal) - 检查
DATABASE_URL是否含未 URL 编码的特殊字符,例如密码里的@必须变成%40 - 确认
serverVersion参数存在且匹配实际 MySQL 版本,否则 Doctrine 可能跳过某些兼容性适配,间接引发握手失败
连接泄漏没被回收,最终触发 MySQL max_connections 溢出
不是单次断开,而是积少成多:比如在循环里反复 new PDO 却没 unset,或 Doctrine EntityManager 没被正确释放(尤其在命令行长任务中),会导致连接数持续增长。MySQL 达到 max_connections 后,新请求直接被拒,现象就是“连不上”,日志里常出现 Too many connections。
- 命令行任务务必在 finally 块中显式调用
$em->close() - Web 请求中避免在 controller 外部手动 new EntityManager
- 用
show status like 'Threads_connected';实时观察连接数,结合netstat -anp | grep :3306 | wc -l交叉验证
真正麻烦的不是断开本身,而是断开后 PDO 不报错、静默返回空结果,或者只在高并发时偶发——这时候得盯住 MySQL 的 Aborted_connects 和 Aborted_clients 状态变量,它们比应用层日志更诚实。











