在Bun环境中使用Sequelize关闭连接后进程挂起无法退出求助

问题场景 #

使用 Bun 搭配 Sequelize 时，执行查询并手动关闭连接后，进程无法正常退出，一直处于挂起状态。开启 DEBUG=sequelize* 环境变量后，最后输出的日志为：

sequelize:pool connection drain due to process exit +0ms

相关代码片段：

const results = await MyModel.findAll();
console.log(results)
await sequelize.connectionManager.close()

补充说明：需在创建 Sequelize 实例时设置 databaseVersion 选项，才能让代码执行到上述步骤。

原因分析 #

1. Bun 与 Sequelize 连接池的兼容性差异
   Sequelize 的连接池清理逻辑依赖 Node.js 的 process.on('exit') 事件触发连接销毁，但 Bun 的事件循环处理机制和 Node.js 存在区别，导致连接池的 drain 流程没有彻底完成资源释放，残留的异步任务或句柄阻止进程退出。

2. databaseVersion 选项的间接影响
   设置 databaseVersion 会跳过 Sequelize 自动检测数据库版本的异步操作，原本该操作在 Node.js 环境下可能会辅助触发连接池的清理流程；但在 Bun 中跳过这一步后，连接池的资源释放逻辑没有被正确触发，加上 Bun 的事件循环未识别到剩余待清理资源，最终导致进程挂起。

3. 手动关闭连接的不彻底性
   sequelize.connectionManager.close() 仅关闭连接管理器的连接，但 Sequelize 内部可能残留定时器、未完成的微任务（比如连接池的 drain 回调），这些在 Bun 环境下未被正确处理，导致进程无法正常退出。

解决方案 #

• 临时强制退出
  在调用 connectionManager.close() 后，手动触发进程退出：

const results = await MyModel.findAll();
console.log(results);
await sequelize.connectionManager.close();
process.exit(0);

• 优化连接池配置
  调整 Sequelize 连接池参数，让闲置时自动释放所有连接：

const sequelize = new Sequelize({
  // 其他数据库配置
  pool: {
    max: 5,
    min: 0, // 闲置状态下释放所有连接
    idle: 1000,
    acquire: 3000,
    evict: 1000,
  },
  databaseVersion: 'xxx', // 填入你的数据库版本
});

• 调用 Sequelize 实例的完整关闭方法
  使用 sequelize.close() 替代单独关闭连接管理器，该方法会触发完整的资源清理流程：

const results = await MyModel.findAll();
console.log(results);
await sequelize.close();

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