mysql2抛出PROTOCOL_UNEXPECTED_PACKET错误无法定位原因该如何解决

云上老周

2026-10-5

你遇到的PROTOCOL_UNEXPECTED_PACKET错误并非未关闭的连接导致，根源是mysql2 1.7.0版本的内部队列逻辑在收到无对应请求的mysql返回包时的异常抛出，可按以下步骤排查解决：

先解决依赖冲突问题：你的项目同时依赖了mysql和mysql2两个数据库驱动包，二者API存在重叠会导致连接状态错乱，先卸载不需要的驱动：npm uninstall mysql。
升级mysql2版本：1.7.0版本存在多个已知的协议解析bug，可升级到兼容node 9.11.1的最新稳定版本：npm install mysql2@2.3.3，该版本修复了空队列场景下的数据包误判问题。
修正连接使用逻辑：不要在数据库请求回调执行前手动关闭连接，避免mysql返回结果到达时，连接队列已被清空触发异常，写法参考：

// 错误写法
connection.query('SELECT * FROM 表名', (err, res) => {});
connection.end(); // 提前清空队列，数据包返回时就会报错

// 正确写法
connection.query('SELECT * FROM 表名', (err, res) => {
  // 所有逻辑处理完再关闭连接，或直接使用连接池自动管理连接生命周期
  connection.end();
});

补充连接配置和异常捕获：在mysql2初始化配置中添加对应参数，同时主动监听error事件避免进程直接崩溃：

const mysql = require('mysql2');
const connection = mysql.createConnection({
  host: '你的数据库地址',
  user: '数据库用户名',
  password: '数据库密码',
  database: '数据库名',
  // 核心修复配置
  enableKeepAlive: true,
  keepAliveInitialDelay: 10000,
  autoCommit: true,
  maxPreparedStatements: 100
});
// 必须添加error事件监听，避免未捕获错误直接导致进程退出
connection.on('error', (err) => {
  console.error('数据库连接错误', err.code);
  // 出现致命错误时自动执行重连逻辑
  if (err.fatal) {
    // 此处添加重新创建连接的逻辑即可
  }
});