Knex连接Postgres后Node进程无法终止问题排查求助

首先，你遇到的两个现象——Node进程无法终止和**logger.info('finished')未执行**，核心原因都是Knex的数据库连接池没有被正确关闭：

为什么进程无法终止？ #

Knex初始化时会根据你的配置创建一个连接池（你配置了max:7），即使你的SELECT 1查询已经执行完成，连接池里的空闲连接会保持活跃状态（长连接）。Node.js进程会等待所有活跃的网络连接/事件循环句柄释放后才会自动退出，这些未关闭的数据库连接会一直占用句柄，阻止进程正常终止。

为什么logger.info('finished')没执行？ #

按代码顺序，这条同步日志应该在database.raw()的异步回调之前执行，但大概率是这两种情况导致你没看到：

1. 你的日志系统是异步输出（需要缓冲区刷新），但进程被卡住无法退出，导致日志没来得及刷到控制台；
2. 你可能误解了执行顺序——Promise的then回调是异步的，但同步代码logger.info('finished')其实已经执行了，只是被后面的查询结果日志覆盖，或者日志级别配置导致没显示。

不过不管哪种情况，解决连接池的问题后，进程正常退出时日志都会正常输出。

解决方案：手动销毁Knex连接池 #

在查询完成（无论成功或失败）后，调用knex.destroy()关闭所有连接池连接，释放事件循环句柄，让进程正常退出。同时把finished日志放在finally块里，确保一定会执行：

const database = require('../database.connector')
database.raw('SELECT 1;')
  .then(function (data) { 
    logger.info(data); 
  })
  .catch(function (error) { 
    logger.error(error);
  })
  .finally(() => {
    // 销毁连接池，释放所有连接
    return database.destroy()
      .then(() => {
        logger.info('finished');
      });
  });

额外说明 #

• 你已经配置了pool.min:0，这会让连接池在空闲时释放所有连接，但这只适用于长期运行的服务场景；对于单次测试脚本，还是需要手动调用destroy()来立即关闭所有连接。
• 如果是在长期运行的服务（比如Express API）中，你不需要手动销毁连接池，因为服务需要保持连接池来处理后续请求；但在一次性脚本/测试代码中，必须手动销毁才能让进程正常退出。

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