如何通过Sequelize自动关闭pgAdmin中闲置的PostgreSQL进程

API 探路者

2026-9-27

问题核心排查与解决方案

你当前遇到的连接数超出pool.max配置的问题，可按照以下优先级排查：

多进程部署导致总连接数堆叠
Sequelize的连接池是单实例隔离的，如果你用PM2集群模式、容器多副本等方式启动了多个Node.js进程，每个进程都会独立创建一个最大15连接的连接池。如果启动了3个进程，总连接上限就为45，和你观测到的35个闲置进程匹配属于正常情况。
解决方案：根据你的PostgreSQL实例总连接上限（默认100），调整单进程的pool.max数值，总连接数=进程数*单进程pool.max，建议预留20%的连接余量给pgAdmin、备份等其他操作。

参数理解与配置补充
你对evict参数的理解存在偏差：evict定义的是「闲置连接清理任务的运行间隔」，真正控制「连接闲置多久可被释放」的是你配置的idle: 10000参数，当前这两个参数的组合逻辑是正确的。
可补充以下配置增强连接回收能力：

sequelize = new Sequelize(process.env[config.use_env_variable], {
  logging: false,
  pool: {
    max: 15,
    min: 0,
    acquire: 30000,
    idle: 10000,
    evict: 10000,
    // 新增：开启连接存活校验
    validate: (connection) => connection.active !== false
  },
  dialect: 'postgres',
  // 新增：PostgreSQL 连接专属配置
  dialectOptions: {
    keepAlive: true,
    // 事务闲置超过60秒自动断开，避免事务泄漏占住连接
    idle_in_transaction_session_timeout: 60000
  }
});

事务泄漏问题排查
未正常提交/回滚的事务会一直占用连接，不会进入闲置池被回收。全局检索项目中所有sequelize.transaction相关代码，确认所有事务逻辑都包含完整的try-catch结构，异常时主动执行rollback，避免未完成的事务一直持有连接。
依赖版本Bug修复
你使用的Sequelize v6.6.2属于较早的v6版本，存在已知的连接池回收逻辑Bug，可升级到最新的v6稳定版修复：
```
npm install sequelize@6.x pg pg-hstore
```