Node.js连接MySQL报错Packets out of order. Got:0 Expected:244求助

1. 调整Sequelize连接池配置，匹配MySQL超时规则 #

你遇到的PROTOCOL_PACKETS_OUT_OF_ORDER错误绝大多数场景是连接池中的空闲连接被MySQL服务端/网络链路主动断开后，Sequelize仍使用失效连接发起请求导致的协议异常。
修改MySQL连接文件配置如下：

const Sequelize = require('sequelize')
const dotenv = require('dotenv');
dotenv.config();

const sequelize =
  new Sequelize(process.env.DBNAME, process.env.DBUSER, process.env.DBPASS,
    {
      host: process.env.HOST,
      port: process.env.HOST_PORT,
      dialect: 'mysql',
      operatorsAliases: 0, //false,
      timezone: "+06:00",
      // 新增重试配置
      retry: {
        max: 3
      },
      // 新增方言选项，开启连接超时控制
      dialectOptions: {
        connectTimeout: 60000
      },
      pool: {
        max: 5,
        min: 0,
        acquire: 30000,
        // 空闲时间调整为小于MySQL的wait_timeout、网络链路空闲超时的数值，默认MySQL wait_timeout为28800秒（8小时），如果有云服务商安全组/网关超时，按更小值设置
        idle: 1800000, // 30分钟
        // 新增evict参数，定时清理失效连接
        evict: 10000
      }
    }
  )

// 新增全局连接错误监听，避免未捕获错误直接挂掉服务
sequelize.authenticate().catch(err => {
  console.error('连接验证失败，触发重连: ', err);
  setTimeout(() => setConnection(), 3000);
})

module.exports = sequelize;

2. 替换过时的MySQL驱动 #

你当前使用的mysqlnpm包已经停止维护，存在大量未修复的协议层bug，建议替换为社区维护的mysql2驱动：

npm uninstall mysql
npm install mysql2

Sequelize默认兼容mysql2，无需修改其他业务代码。

3. 新增连接健康检查机制 #

在服务启动与连接初始化文件中增加定期健康检查逻辑，定时验证连接可用性：

// 新增：每15分钟检查一次数据库连接
setInterval(() => {
  db.query('SELECT 1')
    .catch(err => {
      console.error('连接心跳检测失败，触发重连: ', err);
      setConnection();
    })
}, 900000)

同时修改onError函数，增加对PROTOCOL_PACKETS_OUT_OF_ORDER错误码的处理，触发自动重连而不是直接抛出错误退出进程。

4. 确认MySQL配置永久生效 #

你当前执行的set global配置是临时生效的，MySQL重启后会失效，需要修改MySQL配置文件（my.cnf/my.ini）添加以下配置，重启MySQL后永久生效：

net_buffer_length=1M
max_allowed_packet=1G
wait_timeout=28800
interactive_timeout=28800

5. 排查网络链路问题 #

如果你的服务和MySQL部署在不同服务器/云平台上，检查以下配置：

• 安全组、防火墙的空闲连接超时阈值，确保连接池idle配置小于该阈值
• 有没有NAT网关、代理层会主动断开长时间空闲的TCP连接
• 排查两台服务器之间的网络丢包情况，TCP丢包也会导致MySQL包序号错乱

6. 定位具体触发错误的SQL #

启动服务时添加环境变量打印MySQL交互日志，定位触发错误的具体请求：

set NODE_DEBUG=mysql && npm start

查看报错前最后执行的SQL语句，确认是否存在大字段查询、批量写入等返回数据量过大的请求，对应优化SQL逻辑或拆分请求。

内容的提问来源于stack exchange，提问作者A.K.M. Arifur Rahman