Node.js MySQL部署应用出现ECONNRESET错误，本地正常如何解决？

ECONNRESET错误表示TCP连接被对方（MySQL服务器）主动重置，本地正常但服务器异常，核心是环境配置或网络差异导致的，按以下步骤排查解决：

1. 检查MySQL服务器的连接超时配置 #

• 服务器端MySQL可能设置了过短的闲置连接超时时间，执行以下SQL查看参数：

  SHOW VARIABLES LIKE '%timeout%';
  

• 重点关注wait_timeout和interactive_timeout，若值过小（比如小于1小时），修改MySQL配置文件（my.cnf或my.ini）：

  wait_timeout = 86400
  interactive_timeout = 86400
  

• 修改后重启MySQL服务生效。

2. 优化Node.js数据库连接池配置 #

• 本地单连接场景不易暴露问题，服务器高并发下需配置带重连机制的连接池，示例配置：

  const mysql = require('mysql');
  const pool = mysql.createPool({
    host: '你的数据库地址',
    user: '数据库用户名',
    password: '数据库密码',
    database: '目标数据库',
    connectionLimit: 10,
    acquireTimeout: 60000,
    timeout: 60000,
    socketOptions: {
      keepAlive: true,
      keepAliveInitialDelay: 300000 // 5分钟发送一次保活包
    }
  });
  

• 绑定连接池错误处理器，避免未处理错误导致进程崩溃：

  pool.on('error', (err) => {
    console.error('连接池异常:', err);
    if (err.code === 'ECONNRESET') {
      // 可在此添加重连触发或日志记录逻辑
    }
  });
  

3. 排查服务器防火墙/安全组规则 #

• 服务器防火墙或云服务商安全组可能存在TCP连接闲置超时限制，需确保3306端口的长期连通性：
  • 若使用云服务器，检查安全组是否允许服务器IP持续访问MySQL端口；
  • 开启Node.js连接的TCP保活（见步骤2的socketOptions配置），避免被防火墙判定为闲置连接断开。

4. 确认MySQL用户访问权限 #

• 本地可能用localhost连接，服务器需确认MySQL用户允许从当前服务器IP访问：
  • 执行SQL查看用户权限范围：

    SELECT user, host FROM mysql.user;
    

  • 若目标用户的host不是%（允许所有IP）或当前服务器IP，执行授权命令：

    GRANT ALL PRIVILEGES ON 你的数据库.* TO '用户名'@'服务器IP' IDENTIFIED BY '密码';
    FLUSH PRIVILEGES;
    

5. 检测服务器网络稳定性 #

• 在服务器上执行以下命令测试MySQL端口连通性，观察是否有丢包或断开：

  telnet 你的数据库地址 3306
  # 或使用ping持续测试
  ping 你的数据库地址 -t
  

• 若存在网络波动，联系服务器/数据库服务商排查链路问题。

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