如何处理ThinkPHP命令行下的数据库连接断开_PDO长连接与自动重连机制-ThinkPHP-PHP中文网

thinkphp命令行执行时pdo连接超时断开的典型表现是报“mysql server has gone away”或卡住无响应；根本原因是mysql的wait_timeout到期或网络中断，而tp6默认不自动重连，需在业务层通过ping检测、异常捕获及手动重连来兜底。

如何处理thinkphp命令行下的数据库连接断开_pdo长连接与自动重连机制

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() 检测连接是否还活着；如果失败，就强制关闭旧连接再重建。

btpanel phpsite 宝塔面板PHP网站

宝塔面板 PHP 网站管理：站点创建、删除、启停、PHP 版本切换、域名管理、SSL证书管理、伪静态管理、数据库管理

下载

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() 并捕获特定错误码。