Node.js在Windows环境使用busboy上传触发limit事件时报read ECONNRESET错误

根因分析 #

这个问题是Windows和Linux的TCP栈实现差异，结合你当前终止上传的逻辑缺陷共同导致的：

• Windows的TCP栈对未完成数据传输就主动断开的连接处理更严格：当你调用req.unpipe(busboy)后，请求体还有未消费完的上传数据，此时你直接返回错误响应，Windows内核会认为连接是被异常中断，主动发送RST包终止连接，Node.js的HTTP模块监听到这个RST包就会抛出ECONNRESET错误。
• Linux的TCP栈对这类场景的处理更宽松：内核会自动静默丢弃未消费的请求体数据，不会主动触发连接重置错误，所以你的代码在Linux下运行正常。

修复方案 #

调整limit事件的处理逻辑，主动消费残留请求数据、清理资源即可解决Windows下的报错：

file.on('limit', async () => {
  removeFile(organizationId, fileName); 
  // 断开管道传输
  req.unpipe(busboy);
  // 主动消费请求流剩余数据，丢弃不处理
  req.resume();
  // 销毁busboy实例清理占用资源
  busboy.destroy();
  next(new Error('File too large'));
});

如果仍有偶发的ECONNRESET报错，可以给请求对象添加错误监听，过滤这类无业务影响的平台特定报错：

req.on('error', (err) => {
  // 仅忽略Windows下触发的连接重置错误，其余错误正常抛出
  if (err.code !== 'ECONNRESET') throw err;
});

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