如何释放Node.js中被Read Stream占用的资源以删除文件/文件夹？

嘿，我太懂你这个头疼的状况了——明明已经调用了destroy()和unpipe()，视频流却还死死占着文件，导致POST请求后没法删除文件夹，只有重启Node应用才能解决。结合你的代码场景，我给你梳理几个关键的排查点和解决办法：

1. 确保流在所有场景下都被正确销毁 #

你之前用了全局变量来存流，但其实这反而容易出问题——多个请求会覆盖这个变量，导致旧的流引用丢失，没法正确销毁。应该在请求作用域内处理流，并且监听响应结束、客户端断开、流错误这几个关键事件，确保流被彻底销毁：

const fs = require('fs');
const express = require('express');
const app = express();

app.get('/api/video/:folder', function(req, res) {
  const folder = req.params.folder; // 注意你原代码里变量名写错了，应该是folder不是streamer
  const videoPath = `D:/Clips/${folder}/clip.mp4`;
  
  // 在请求作用域内创建流，避免全局变量的混乱
  const fileStream = fs.createReadStream(videoPath);

  // 将流pipe到响应
  fileStream.pipe(res);

  // 当响应完全发送完毕（finish事件），销毁流
  res.on('finish', () => {
    if (!fileStream.destroyed) {
      fileStream.destroy();
    }
  });

  // 当客户端中途断开连接（比如用户关掉页面），立即销毁流
  res.on('close', () => {
    if (!fileStream.destroyed) {
      fileStream.destroy();
    }
  });

  // 监听流的错误事件，防止出错后资源泄漏
  fileStream.on('error', (err) => {
    console.error('视频流出错:', err);
    if (!res.headersSent) {
      res.status(500).send('视频流加载失败');
    }
    fileStream.destroy();
  });
});

2. 检查POST请求中是否有未关闭的资源 #

你的问题是POST请求后要删除文件夹，那得确保POST请求里操作该文件夹的所有流（比如写入、读取）都已经正确关闭。比如如果POST里有上传文件到这个文件夹的逻辑，一定要确保写入流调用了end()或者destroy()，并且监听了finish事件。

3. 给文件系统一点释放资源的时间 #

有时候Node.js销毁流后，文件系统不会立刻释放文件锁，你可以在销毁流后加个短暂的延迟再尝试删除文件夹（这是个临时 workaround，但有时候很管用）：

// 假设这是你的POST请求处理逻辑
app.post('/api/delete-folder', async (req, res) => {
  const folder = req.body.folder;
  // 先确保相关流都已经销毁（比如上面的视频流已经处理完）
  setTimeout(async () => {
    try {
      // 使用Node.js 14+支持的fs.rm递归删除文件夹
      await fs.promises.rm(`D:/Clips/${folder}`, { recursive: true, force: true });
      res.send('文件夹删除成功');
    } catch (err) {
      console.error('删除文件夹失败:', err);
      res.status(500).send('删除文件夹失败');
    }
  }, 1000); // 延迟1秒，给文件系统释放锁的时间
});

4. 升级Node.js到LTS版本 #

旧版本的Node.js在流的销毁机制上可能存在bug，比如某些场景下destroy()不会彻底释放文件描述符。升级到最新的LTS版本（比如16.x或18.x），很多这类资源泄漏问题都会被修复。

最后再提个小提醒 #

尽量避免用全局变量存储流对象，每个请求的流都应该在自己的作用域内管理，这样能最大程度避免引用混乱和资源泄漏。

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