明明已关闭所有句柄，Node.js为何仍报未关闭文件描述符？

你遇到的问题核心是并非所有场景下stream的close事件都会触发，导致handle.close()没被执行，最终文件句柄被垃圾回收器关闭，触发警告。以下是具体原因和修复方案：

可能的触发场景 #

• 客户端提前断开连接：当HTTP客户端（如浏览器）在响应完成前主动断开（比如刷新页面、关闭标签页），res对象会触发aborted事件，此时stream.pipe(res)的过程会被中断，stream的close事件可能不会触发，导致handle未被显式关闭。
• 流发生错误：如果stream在读取过程中出现错误（比如文件被意外删除），会触发error事件而非close事件，同样会跳过handle.close()的调用。
• 异步时序遗漏：handle.close()是异步操作，但代码未处理其可能的异常，同时未覆盖所有流程分支的资源清理。

修复代码 #

修改代码，覆盖所有异常/中断场景，确保handle总能被显式关闭：

let handle;
try {
  handle = await getFile();
  const stream = handle.createReadStream();
  const stat = await handle.stat();

  res.setHeader("content-length", stat.size);
  res.setHeader("content-type", "application/octet");
  res.statusCode = 200;

  // 监听客户端断开事件，主动清理资源
  res.on('aborted', () => {
    stream.destroy();
    handle.close().catch(err => console.error('关闭文件句柄失败:', err));
  });

  // 监听流读取错误，及时关闭句柄
  stream.on('error', (err) => {
    console.error('文件流读取错误:', err);
    res.statusCode = 500;
    res.end('文件读取失败');
    handle.close().catch(err => console.error('关闭文件句柄失败:', err));
  });

  // 流正常关闭时清理句柄
  stream.on('close', () => {
    handle.close().catch(err => console.error('关闭文件句柄失败:', err));
    // 无需手动调用res.end()，pipe完成后会自动结束响应
  });

  stream.pipe(res);
} catch (err) {
  console.error('文件处理流程出错:', err);
  res.statusCode = 500;
  res.end('服务器内部错误');
  // 初始化阶段出错时，确保句柄被关闭
  if (handle) {
    handle.close().catch(err => console.error('关闭文件句柄失败:', err));
  }
}

关键优化点 #

• 用try/catch包裹全流程，覆盖初始化阶段的错误场景，确保句柄能被关闭
• 监听res.aborted事件，处理客户端主动断开的情况
• 监听stream.error事件，处理读取异常时的资源清理
• 移除stream.close中的res.end()，避免重复结束响应的问题
• 捕获handle.close()的Promise异常，避免未捕获错误

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