Node.js中检测HTTP连接断开：response未触发close事件

核心问题分析 #

你遇到的res对象close事件不触发的情况，大概率是这几个原因：

• 全局可读流被复用，流已经耗尽后无法再产生数据，导致res直接触发finish而非close
• 客户端断开时，req对象的close事件比res更先被触发，而你只监听了res的事件
• 流未添加错误监听，出错后导致事件链路中断

具体解决方案 #

1. 监听req的close事件替代（或补充）res的close #

客户端主动断开连接时，请求对象的close事件触发更可靠，建议同时监听：

module.exports.getContent = (req, res) => {
  // 监听客户端断开连接
  req.on('close', () => {
    console.log('客户端已断开连接');
  });

  res.on('close', () => {
    console.log('响应连接已关闭');
  });

  // 区分正常完成的情况
  res.on('finish', () => {
    console.log('响应已正常发送完毕');
  });

  // ...后续逻辑
};

2. 禁止复用全局可读流 #

全局的readableStream是一次性的，一旦流的end事件触发（数据消费完），再次pipe到res时不会产生任何数据，res会直接结束并触发finish，自然不会触发close。每次请求都要创建新的流实例：

// 正确做法：每次请求创建新流
module.exports.getContent = (req, res) => {
  const readableStream = fs.createReadStream('path/to/your/file'); // 每次请求新建

  req.on('close', () => {
    console.log('客户端已断开');
    // 手动销毁流，避免资源浪费
    readableStream.destroy();
  });

  // 给流添加错误监听，防止出错后事件丢失
  readableStream.on('error', (err) => {
    console.error('流读取错误:', err);
    res.status(500).end('服务器内部错误');
  });

  readableStream.pipe(res);
};

3. 关键事件区分 #

• res.finish：响应数据全部发送完毕时触发（正常结束场景）
• res.close：响应连接被强制中断时触发（客户端断开、网络异常等场景）
• req.close：客户端主动断开连接时触发，比res.close更灵敏

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