MySQL报Got packets out of order(MY-010914)根本原因是协议解析失败,常见于max_allowed_packet过小导致截断、MySQL Shell 8.x协议切换残留、多进程复用连接、caching_sha2_password认证不兼容等场景。

这不是网络乱序,是协议解析失败的明确信号。MySQL 报 Got packets out of order(错误码 MY-010914)时,客户端已收包但校验失败,服务端日志里看到的不是“丢包”,而是“包头对不上”——比如客户端期待第一个 packet 的序列号是 1,结果收到的是 56,直接判定协议流崩溃。
max_allowed_packet 太小导致服务端截断响应
当查询返回大字段(如 BLOB、长 JSON、GROUP_CONCAT 结果)或执行 LOAD DATA 时,若结果体积超过 max_allowed_packet,服务端会静默截断后续 packet,但客户端仍按完整协议帧等待,最终收到非法起始字节(常见报错:Got: 0 Expected: 16)。
-
show variables like 'max_allowed_packet'查当前值,默认常为4194304(4MB)或更低 - 仅执行
SET GLOBAL max_allowed_packet = 67108864不影响已有连接,必须写入配置文件(如/etc/my.cnf的[mysqld]段),设为max_allowed_packet = 64M并重启mysqld - 客户端连接后建议立即执行
SET SESSION max_allowed_packet = 67108864,确保会话级一致;注意该值不能大于服务端全局值,否则会被静默降级
MySQL Shell 8.x 默认尝试 X 协议引发协议切换残留
MySQL Shell 8.0–8.4 在未显式指定协议时,会先连 mysqlx(X Protocol),失败后再 fallback 到经典协议。这个切换过程可能留下未清理的 socket 状态,服务端记录 MY-010914,但连接本身仍可用——属于误报,但会污染日志、干扰排查。
安装、修复、更新或打包一个基于 Python 和 PyMySQL 实现的 Windows `mysql` 命令。适用于用户希望在 PowerShell/CMD 中输入 `mysql` 时重定向到 Python 实现、需要交互式输入 MySQL 连接信息、需要同步到当前用户本地 bin 目录,或需要将该能力封装成可公开复用的 Codex skill。
- 复现命令:
mysqlsh root@localhost:3306(无协议前缀) - 修复方式:强制使用经典协议,改用
mysqlsh mysql://root@localhost:3306 - MySQL Shell 9.0+ 已修复,但生产环境若混用 8.x 版本,所有调用必须加
mysql://前缀
多进程共享同一 MySQL 连接句柄
在 Swoole、PHP-FPM 子进程、或 Python multiprocessing 场景中,若父进程创建了 MySQL 连接(如 PDO 或 MySQLi 实例),再 fork 出子进程并复用该连接,会导致多个进程向同一 socket 写入/读取,协议帧完全错乱。典型现象是报错中伴随 Packets out of order. Expected 1 received 56. Packet size=3420216 和后续 MySQL server has gone away。
- 绝对禁止跨进程复用连接句柄,哪怕只是只读查询
- 每个进程必须独立建立新连接,或引入连接池(如 ProxySQL、pt-query-digest 配合连接池中间件,或应用层 pool 实现)
- PHP 中尤其注意:Swoole Worker 启动时不要在全局 scope 初始化 DB 连接,应在每个
onWorkerStart回调内新建
caching_sha2_password 认证插件与旧客户端不兼容
MySQL 8.0 默认用户认证插件为 caching_sha2_password,但老版本驱动(如 mysql-connector-python 、某些 ORM 内置连接器)只支持 <code>mysql_native_password。握手阶段服务端发送非预期包结构,客户端无法解析,直接触发 Got packets out of order 并断连。
- 检查用户插件:
SELECT user, host, plugin FROM mysql.user WHERE user = 'your_user'; - 临时兼容方案:
ALTER USER 'your_user'@'%' IDENTIFIED WITH mysql_native_password BY 'password'; - 长期方案:升级客户端驱动,或在
my.cnf中设default_authentication_plugin = mysql_native_password(仅限测试/过渡环境)
真正棘手的是这几种原因常混合出现:比如 max_allowed_packet 小 + caching_sha2_password + Swoole 多进程,错误日志里 MY-010914 和 Aborted connection 交替刷屏。优先查 performance_schema.error_log 过滤 MY-010914,再结合客户端实际调用栈和连接生命周期判断根因——别被“out of order”字面意思带偏节奏。

















