Node写入流挂起问题：脚本输出记录后无法终止

这种情况通常是因为事件循环里还有活跃的异步资源没被释放，导致Node.js认为脚本还在运行，不会自动退出。虽然finish事件触发了，但可能还有未关闭的数据库连接、定时器、打开的流或者其他挂起的异步请求在占用事件循环。

下面给你几个实用的解决思路：

1. 先检查并清理所有外部资源 #

先梳理下你的脚本用到了哪些外部服务或资源，针对性做释放：

• 如果用了数据库（MongoDB/MySQL/Redis等）：一定要在finish事件里调用断开连接的方法，比如Mongoose的mongoose.disconnect()，MySQL的connection.end()，Redis的client.quit()。
• 如果用了文件流/网络流：有些流的finish事件仅代表数据写入完成，不代表底层资源完全释放，最好监听close事件确认资源回收，或者主动调用stream.destroy()。
• 如果有定时器（比如setInterval）：哪怕定时器已经执行完毕，没调用clearInterval清除的话，它依然会占用事件循环。

举个数据库连接清理的例子：

writeStream.on('finish', () => {
  console.log('records written: 442');
  // 清理MongoDB连接
  mongoose.disconnect()
    .then(() => console.log('数据库连接已关闭，脚本即将退出'))
    .catch(err => console.error('关闭连接失败:', err));
});

2. 调试找出隐藏的活跃句柄 #

如果不知道哪里还在占用资源，可以在finish事件里打印当前的活跃句柄和请求，帮你定位问题：

writeStream.on('finish', () => {
  console.log('records written: 442');
  // 打印活跃句柄（内部API，仅用于调试）
  console.log('当前活跃句柄:', process._getActiveHandles());
  // 打印活跃请求
  console.log('当前活跃请求:', process._getActiveRequests());
});

运行后看输出，就能明确看到哪些资源没被释放——比如某个未关闭的socket、数据库连接实例，再针对性处理就行。

3. 强制退出（万不得已再用） #

如果你确认所有业务任务都已经完成，只是找不到事件循环挂起的原因，可以在finish事件里手动终止进程：

writeStream.on('finish', () => {
  console.log('records written: 442');
  // 0表示正常退出，非0值代表错误退出
  process.exit(0);
});

不过这种方式比较粗暴，可能会导致部分资源无法正常释放（比如数据库连接没优雅断开），所以优先推荐前两种方法，实在没办法再用这个。

4. 检查是否有遗漏的异步操作 #

有时候一些不起眼的异步任务会拖垮事件循环：比如某个fetch请求没处理回调、某个Promise一直处于pending状态、或者fs模块的异步方法没执行完。仔细排查代码里的所有异步逻辑，确保它们都已完成或被正确处理。

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