ThinkPHP命令行执行时PDO连接超时断开的典型表现是报“MySQL server has gone away”或卡住无响应；根本原因是MySQL的wait_timeout到期或网络中断，而TP6默认不自动重连，需在业务层通过ping检测、异常捕获及手动重连来兜底。
ThinkPHP 命令行执行时 PDO 连接超时断开的典型表现
命令行脚本跑着跑着突然报 PDOException: SQLSTATE[HY000] [2006] MySQL server has gone away，或者更隐蔽地卡在某次查询后无响应——这不是代码逻辑错，是连接被 MySQL 主动踢了。MySQL 默认 wait_timeout 是 28800 秒（8 小时），但命令行任务若单次执行时间长、或中间有长时间休眠（比如 sleep(300)），就很容易触发这个断开。
TP6 中手动启用 PDO 长连接不等于自动重连
很多人以为在数据库配置里加了 'persistent' => true 就万事大吉，其实这只是让 PHP 复用底层 socket，不解决“连接已失效却还拿它查数据”的问题。TP6 的 Connection 类默认不做连接存活检测，一旦连接断了，下一次 query() 或 execute() 就直接抛异常。
-
'persistent' => true只对 CLI 模式有效，Web 模式下会被忽略 - 即使启用了长连接，MySQL 仍可能因网络抖动、服务重启、
wait_timeout到期而中断连接 - TP6 不会自动捕获
SQLSTATE[HY000] [2006]并重试，必须自己兜底
在关键查询前主动 ping 连接 + 异常后重连的最小可行方案
别指望框架自动修好，得在业务层做防御。最轻量的做法是在每次执行重要 SQL 前，先调用 ping() 检测连接是否还活着；如果失败，就强制关闭旧连接再重建。
use think\facade\Db;
// 示例：封装一个带保活的查询函数
function safeQuery($sql, $bind = []) {
try {
// 先 ping，失败则重连
if (!Db::getPdo()->getAttribute(\PDO::ATTR_CONNECTION_STATUS)) {
Db::close(); // 关闭当前连接
Db::connect(); // 触发新连接
}
return Db::query($sql, $bind);
} catch (\PDOException $e) {
if (strpos($e->getMessage(), 'MySQL server has gone away') !== false) {
Db::close();
Db::connect();
return Db::query($sql, $bind);
}
throw $e;
}
}
注意：Db::getPdo()->getAttribute(\PDO::ATTR_CONNECTION_STATUS) 在部分 PDO 版本中不可靠，所以更稳妥的是直接 try-catch query() 并捕获特定错误码。
立即学习“PHP免费学习笔记（深入）”；
CLI 脚本里避免连接堆积和资源泄漏
命令行脚本通常循环处理大量数据，每轮都新建连接却不释放，会导致 MySQL 报 Too many connections。TP6 的连接池机制在 CLI 下不生效，必须人工干预。
- 不要在循环内反复调用
Db::connect()，复用同一个连接实例 - 用完记得
Db::close()，尤其在 long-running 脚本末尾或子进程退出前 - 如果用了事务，务必确保
commit()或rollback()后显式close()，否则连接可能卡在“未提交”状态被 MySQL 杀掉 - 避免在
pcntl_fork()后父子进程共用一个 PDO 实例——PDO 不支持多进程共享，会引发段错误
连接不是越长越好，关键是“用前检查、用后清理、出错重试”。CLI 场景下，没人帮你兜底，得自己把连接当易碎品来对待。
