PM2管理下Sequelize事务API运行一段时间后失效问题求助

问题描述 #

在Ubuntu 20.04服务器上，使用PM2 5.2.2管理Express（~4.16.1）+ Sequelize（^6.7.0）应用时，所有涉及Sequelize事务的API运行一段时间后会停止响应，请求处于pending状态；但普通查询API可正常运行。重启PM2后功能恢复，但数小时后问题会再次复现。

可能的原因及排查方向 #

1. 事务未正确提交/回滚，导致连接池耗尽 #

Sequelize的事务会占用连接池中的连接，若未在所有代码路径中明确调用commit()或rollback()，连接会被长期占用无法释放。当连接池被这类未收尾的事务占满后，新的事务请求无法获取连接，就会一直处于等待状态。

• 排查代码中是否存在分支遗漏：比如异常未捕获、异步操作错误未处理导致事务未收尾。示例错误代码：

  const t = await sequelize.transaction();
  try {
    await User.create({ name: 'test' }, { transaction: t });
    // 若此处抛出异常，事务未被回滚
  } catch (err) {
    // 遗漏t.rollback()调用
  }
  

• 确保所有路径（包括异步错误分支）都执行事务的收尾操作，建议使用finally块兜底：

  const t = await sequelize.transaction();
  try {
    await User.create({ name: 'test' }, { transaction: t });
    await t.commit();
  } catch (err) {
    await t.rollback();
    throw err;
  }
  

2. PM2集群模式与连接池配置不匹配 #

若PM2启用集群模式（默认会启动多进程），Sequelize每个进程都会维护独立的连接池。如果单进程连接池max值过大，总连接数会超出数据库的max_connections限制，导致新的事务请求无法获取连接而挂起。

• 计算总连接数：PM2进程数 × Sequelize连接池max，需确保该值小于数据库的最大连接数（MySQL默认151，PostgreSQL默认100）。
• 调整Sequelize连接池的max参数，或在PM2配置中限制进程数量（比如pm2 start app.js -i 2指定2个进程）。

3. Sequelize版本存在事务相关Bug #

Sequelize 6.7.0属于较早的6.x版本，可能存在事务处理时的连接释放异常或内存泄漏问题，长期运行后导致连接池耗尽。

• 尝试升级Sequelize到6.x系列的最新稳定版本，验证问题是否复现。

4. 未处理的Promise拒绝导致事件循环异常 #

事务中的异步操作若出现未捕获的Promise拒绝，可能导致进程事件循环阻塞，或使Sequelize连接池状态紊乱。

• 检查应用是否配置了全局Promise拒绝处理器：

  process.on('unhandledRejection', (reason, promise) => {
    console.error('未处理的Promise拒绝:', reason);
    // 可在此处添加日志或告警逻辑
  });
  

• 确保所有异步操作的错误都被捕获并处理，避免未处理的拒绝累积。

5. 连接池超时配置不合理，导致无效连接堆积 #

若Sequelize连接池的idle、acquire等超时参数与数据库端的超时设置不匹配，会导致数据库主动关闭闲置连接后，Sequelize连接池仍认为这些连接可用。当事务请求使用无效连接时，会一直等待响应。

• 检查并调整连接池配置：

  const sequelize = new Sequelize({
    // 数据库连接信息
    pool: {
      max: 10, // 单进程最大连接数
      min: 0,
      idle: 10000, // 闲置10秒后释放连接
      acquire: 30000, // 获取连接超时30秒，超时则抛出错误
    }
  });
  

• 确保idle值小于数据库的wait_timeout（MySQL默认8小时），避免数据库提前关闭闲置连接。

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