Node+ExpressJS用MySQL npm包长时间运行后出现PROTOCOL_PACKETS_OUT_OF_ORDER崩溃求助

这个错误本质是MySQL连接因闲置超时被服务器断开后，代码复用了无效连接，加上未捕获连接错误导致进程崩溃。以下是按优先级排列的解决方案：

1. 改用mysql2包（推荐） #

原mysql包已停止维护，mysql2是其升级替代方案，内置更完善的连接池管理、自动重连机制，能自动处理连接失效问题，大幅减少这类底层错误。

步骤： #

• 安装mysql2：

  npm install mysql2
  

• 使用带自动保活的连接池示例：

  const mysql = require('mysql2/promise'); // 支持async/await，更贴合Express异步场景
  const pool = mysql.createPool({
    host: '你的数据库地址',
    user: '数据库用户名',
    password: '数据库密码',
    database: '目标数据库',
    connectionLimit: 10, // 根据业务并发量调整
    enableKeepAlive: true, // 开启连接保活
    keepAliveInitialDelay: 30000 // 每30秒发送一次保活包，防止连接被断开
  });
  
  // 业务中使用连接池的示例（async/await风格）
  async function fetchData() {
    let conn;
    try {
      conn = await pool.getConnection();
      const [rows] = await conn.query('SELECT * FROM your_table');
      return rows;
    } catch (err) {
      console.error('查询失败:', err);
      throw err; // 可根据业务需求处理错误，比如返回500状态码
    } finally {
      if (conn) conn.release(); // 用完必须释放连接回池
    }
  }
  

2. 用原mysql包时，强制连接池+有效性检测 #

如果暂时不想换包，必须用连接池替代单连接，并在获取连接后先检测有效性：

连接池配置+有效性检测示例： #

const mysql = require('mysql');
const pool = mysql.createPool({
  host: '你的数据库地址',
  user: '数据库用户名',
  password: '数据库密码',
  database: '目标数据库',
  connectionLimit: 10,
  acquireTimeout: 60000, // 获取连接超时时间
  timeout: 60000 // 连接闲置超时时间
});

// 获取连接前先ping，确保连接可用
function getValidConnection(callback) {
  pool.getConnection((err, conn) => {
    if (err) return callback(err);
    // 发送ping检测连接是否存活
    conn.ping((pingErr) => {
      if (pingErr) {
        // 连接失效，销毁并重新获取
        conn.destroy();
        return getValidConnection(callback);
      }
      callback(null, conn);
    });
  });
}

// 业务中使用
getValidConnection((err, conn) => {
  if (err) {
    console.error('获取有效连接失败:', err);
    return;
  }
  conn.query('SELECT * FROM your_table', (queryErr, results) => {
    conn.release();
    if (queryErr) console.error('查询失败:', queryErr);
    else console.log(results);
  });
});

3. 捕获连接错误，避免进程崩溃 #

不管用哪种包，必须给连接/连接池绑定error事件处理器，防止未捕获错误导致进程崩溃：

连接池错误监听示例： #

// 给连接池内的每个新连接绑定error事件
pool.on('connection', (conn) => {
  conn.on('error', (err) => {
    console.error('连接错误:', err);
    // 遇到包序错误或连接丢失时，直接销毁连接，让连接池重新创建
    if (err.code === 'PROTOCOL_PACKETS_OUT_OF_ORDER' || err.code === 'PROTOCOL_CONNECTION_LOST') {
      conn.destroy();
    }
  });
});

// 全局未捕获错误兜底（生产环境必备）
process.on('unhandledRejection', (err) => {
  console.error('未处理的Promise拒绝:', err);
  // 生产环境可根据情况决定是否重启进程，比如用pm2自动重启
});

process.on('uncaughtException', (err) => {
  console.error('未捕获的异常:', err);
  process.exit(1); // 异常无法恢复时，退出进程让守护进程重启
});

4. 调整MySQL服务器超时配置（可选） #

如果以上方案都无法快速实施，可以临时调整MySQL的连接超时参数，延长闲置连接存活时间，但这只是治标不治本：

• 执行SQL命令临时生效（重启MySQL后失效）：

  SET GLOBAL wait_timeout = 86400; -- 设置为24小时
  SET GLOBAL interactive_timeout = 86400;
  

• 修改配置文件永久生效（my.cnf或my.ini）：

  [mysqld]
  wait_timeout = 86400
  interactive_timeout = 86400
  

内容的提问来源于stack exchange，提问作者Basil