Sequelize部署后报PROTOCOL_CONNECTION_LOST连接错误问题咨询

核心错误逻辑 #

这个错误代表TCP连接在建立或通信过程中被MySQL服务端（或链路中间的网络设备）主动断开，和账号密码凭据正确性无关——本地环境用相同凭据能正常连接，已经排除了权限、账号密码错误的可能，问题全部出在部署环境的网络链路、连接配置匹配度上。

常见触发原因 #

• 部署环境到数据库的网络链路不通：数据库IP白名单/安全组未放通部署服务的出口IP、跨VPC/跨内网的路由未打通、服务器/容器防火墙拦截了数据库端口
• 连接超时配置不匹配：MySQL服务端设置的空闲连接超时（wait_timeout）小于连接池配置的空闲回收时间，连接被服务端提前销毁，但连接池仍持有失效连接发起请求
• SSL连接要求不匹配：多数云厂商托管数据库默认强制要求SSL连接，本地环境直连可能未做SSL校验也能连通，部署环境经过多跳网络链路时，未携带SSL配置的连接会被服务端直接拒绝
• 链路中间设备超时：部署环境出口的NAT网关、负载均衡、防火墙等设备设置了较短的TCP长连接空闲超时，会主动掐断超过阈值的空闲数据库连接

排查步骤 #

1. 先验证基础网络连通性：登录部署服务所在的容器/物理机，执行端口探测命令

   nc -zv {替换为你的CONFIG.DB_HOST} {替换为你的CONFIG.DB_PORT}
   

   如果命令返回连接超时、连接拒绝，优先解决网络白名单、路由、防火墙问题，不需要调整代码配置。
2. 登录数据库查询服务端超时参数，执行以下SQL：

   SHOW VARIABLES LIKE 'wait_timeout';
   

   记录返回的数值（单位为秒），和你连接池配置的idle参数（你当前配置为10000毫秒即10秒）做对比，如果服务端wait_timeout小于10秒，就会出现连接被主动断开的问题。
3. 登录数据库管理控制台，确认当前数据库实例是否强制开启SSL连接要求。

修复方案 #

1. 补全Sequelize连接配置 #

在你现有配置基础上补充连接超时、自动重试、可选SSL配置，修正后配置参考：

new Sequelize(
  CONFIG.DB,
  CONFIG.DB_USER,
  CONFIG.DB_PASSWORD,
  {
    host: CONFIG.DB_HOST,
    port: CONFIG.DB_PORT,
    dialect: CONFIG.DB_DIALECT,
    define: {
      freezeTableName: true,
    },
    pool: {
      max: 5,
      min: 0,
      acquire: 30000,
      idle: 10000,
    },
    operatorsAliases: 0,
    // 新增配置开始
    dialectOptions: {
      connectTimeout: 60000, // 适配跨网络的连接建立延迟
      // 若数据库强制要求SSL，取消下面ssl段的注释
      // ssl: {
      //   require: true,
      //   rejectUnauthorized: false // 测试环境可临时关闭证书校验，生产环境建议上传对应CA证书
      // }
    },
    retry: {
      match: [
        /PROTOCOL_CONNECTION_LOST/,
        /ETIMEDOUT/,
        /ECONNRESET/
      ],
      max: 3 // 连接异常时自动重试3次，避免偶发网络波动导致接口报错
    }
    // 新增配置结束
  }
);

2. 对应场景修复 #

• 网络连通性问题：将部署服务的固定出口IP添加到数据库的IP白名单，跨VPC场景配置路由打通内网，放通数据库端口的防火墙规则
• 超时配置不匹配问题：如果数据库侧wait_timeout数值过小，要么将数据库参数调整为MySQL默认的28800秒（8小时），要么将连接池的idle参数调整为比wait_timeout小20%的数值，保证连接池在服务端断开连接前主动回收空闲连接
• 中间设备超时问题：确认NAT网关、负载均衡的TCP空闲超时阈值，将连接池idle参数设置为比该阈值小20%的数值，避免连接被中间设备掐断

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