切换MySQL端口后出现连接错误，求原因及解决方案

首先明确：这些连接错误和切换到3306端口本身无关，核心问题出在连接池配置、MySQL服务端参数设置，或者连接复用逻辑上。下面逐个拆解错误原因，并给出针对性修复：

错误原因解析 #

• PROTOCOL_PACKETS_OUT_OF_ORDER：
  本质是MySQL客户端与服务端的数据包传输顺序混乱，常见触发场景：

  • 连接池中的空闲连接已被MySQL服务端主动关闭，但客户端仍尝试复用该连接
  • 网络不稳定导致数据包丢包/乱序
  • 客户端与服务端的MySQL协议版本不兼容（比如mysql2版本过低）

• PROTOCOL_SEQUENCE_TIMEOUT：
  客户端发送请求后，在指定时间内未收到服务端响应。可能原因：

  • 服务端负载过高，无法及时处理请求
  • 连接池中的连接已失效，但客户端未检测到，仍用它发送请求
  • 超时参数设置不合理（比如connectTimeout过长，掩盖了实际连接问题）

• PROTOCOL_CONNECTION_LOST：
  服务端主动断开了连接，常见原因：

  • MySQL的wait_timeout/interactive_timeout参数值小于客户端连接池的idleTimeoutMillis，导致空闲连接被服务端回收
  • MySQL服务端的max_connections被耗尽，主动关闭新连接
  • 网络中断或服务端重启

你的配置存在的明显问题 #

看你给出的连接池配置，有几个关键参数不合理：

1. connectionLimit: 5000：MySQL默认的max_connections仅为151，设置5000的连接池会导致大量连接请求被服务端拒绝，同时耗尽本地资源，直接引发各种连接错误。
2. connectTimeout: 60 * 60 * 1000：1小时的连接超时完全不合理，会导致客户端长时间等待无效连接，放大超时类错误。
3. 未配置连接健康检查：没有启用连接有效性校验，无法及时剔除被服务端关闭的空闲连接。

修复步骤 #

1. 调整连接池核心参数 #

修改你的连接池配置，参考如下合理值：

const pool = mysql.createPool({
  connectionLimit: 20, // 远小于MySQL的max_connections，建议20-50
  connectTimeout: 10000, // 10秒足够，快速失败
  host: process.env.DATABASE_HOST,
  user: process.env.DATABASE_USER,
  password: process.env.DATABASE_PASSWORD,
  database: process.env.DATABASE,
  charset: 'utf8mb4',
  idleTimeoutMillis: 250000, // 比MySQL的wait_timeout小30-60秒
  testOnBorrow: true, // 借连接前检查有效性
  acquireTimeout: 10000 // 获取连接超时时间
});

2. 对齐MySQL服务端超时参数 #

登录MySQL执行以下命令，查看服务端超时设置：

SHOW VARIABLES LIKE 'wait_timeout';
SHOW VARIABLES LIKE 'interactive_timeout';

确保你的idleTimeoutMillis比这两个值小30-60秒（比如服务端是300秒，客户端设250秒），避免服务端先回收连接。

3. 检查MySQL连接数限制 #

执行以下命令查看当前连接数和上限：

SHOW GLOBAL STATUS LIKE 'Threads_connected';
SHOW VARIABLES LIKE 'max_connections';

如果Threads_connected接近max_connections，需要调大服务端的max_connections（不建议超过1000，避免资源耗尽），或者降低客户端的connectionLimit。

4. 查看MySQL服务端日志 #

找到MySQL的错误日志（通常在/var/log/mysql/error.log或本地安装目录下），查看是否有连接被关闭的具体原因（比如权限问题、资源不足），这是定位根因最直接的方式。

5. 验证mysql2版本兼容性 #

确保你的mysql2版本是最新稳定版，避免协议兼容问题：

npm update mysql2

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