SQL 执行报 MySQL server has gone away,怎么排查和解决

程序平时运行正常,一旦执行耗时较长或数据量较大的 SQL,比如批量导入数据、导出报表、跑定时任务,MySQL 就报 MySQL server has gone away,错误码一般是 2006 或 2013。连接像被服务端单方面切断,重试脚本时又可能恢复正常,问题时隐时现。

原因:这个报错的本质是 PHP 把 SQL 发出去时,这条连接已经不存在了,常见于两种场景。一是连接空闲超时被回收:MySQL 的 wait_timeout 参数一到(默认 8 小时,不少服务器被调得更小),服务端主动断开连接,PHP 下一次执行 SQL 就会撞上这个错误。长脚本中途 sleep、定时任务复用上一次的连接,都容易中招。二是单次发送的数据包超过 max_allowed_paCket 限制:一条 INSERT 里塞了大的 BLOB 或很长的文本字段,或者一次拼接几万行的批量插入,服务端收到超限的数据包后直接断开连接,不返回任何解释。

解决步骤:第一步,先查当前参数值,避免盲目修改。在 mysql 客户端或数据库工具里执行:

SHOW VARIABLES LIKE 'max_allowed_packet';
SHOW VARIABLES LIKE 'wait_timeout';

第二步,按场景调整配置。如果是数据包超限,把 max_allowed_packet 调大,编辑 my.cnf(Windows 是 my.ini)的 [mysqld] 段落后重启 MySQL,永久生效:

[mysqld]
max_allowed_packet = 64M
wait_timeout = 28800

不方便重启时可以临时生效:SET GLOBAL max_allowed_packet = 67108864; 注意单位是字节,且只对之后新建立的连接有效,正在跑的脚本要重连一次。

第三步,空闲超时的场景在代码侧加断线重连兜底,比一味调大超时更稳妥。PDO 可以在执行关键 SQL 前先探测连接,断了就重建:

function getPdo($dsn, $user, $pass) {
    try {
        $pdo = new PDO($dsn, $user, $pass);
        $pdo->setAttribute(PDO::ATTR_ERRMODE, PDO::ERRMODE_EXCEPTION);
        $pdo->query('SELECT 1');
        return $pdo;
    } catch (PDOException $e) {
        return new PDO($dsn, $user, $pass); // 断线后重建
    }
}

第四步,从源头减小单次包体积:批量 INSERT 按每 500 到 1000 行拆成一批提交,大字段尽量分条更新,避免一条 SQL 就带着几 MB 的数据发出去。

小结:排查顺序是先用 SHOW VARIABLES 确认 wait_timeout 和 max_allowed_packet;包超限就调大参数并重启生效,空闲断连就在代码里加重连兜底,最后把大 SQL 拆批。两三个参数加一个重连函数,就能解决绝大多数 MySQL server has gone away 报错。

您可以还会对下面的文章感兴趣: