Node.js v18下使用Busboy上传时，还有哪些因素会导致中断？

问题背景 #

我目前使用最新版 Busboy，已知其文档提示 Node.js v18+ 默认启用的 requestTimeout 可能导致长耗时上传中断，已经尝试禁用以下服务器超时配置：

server.requestTimeout = 0;
server.headerTimeout = 0; 
server.keepAliveTimeout = 0;

但仍存在上传中断问题，且不同扩展名文件中断节点不同：

• 50MB 的 rar 文件上传至10%时中断
• 90MB 的 msi 文件上传至80%时中断

前端通过 FormData + XMLHttpRequest 发送请求，此前使用 Node.js 12 时无此问题。

可能的中断原因及解决方案 #

1. Busboy 自身的大小限制未调整 #

Busboy 内置表单数据的大小限制，未显式配置时，若上传内容的某个部分（如文件分片、表单字段）超过默认阈值，会直接中断解析。可以显式配置更大的限制值：

const busboy = new Busboy({
  headers: req.headers,
  limits: {
    fileSize: 200 * 1024 * 1024, // 200MB，按需调整
    fieldSize: 10 * 1024 * 1024,  // 表单单个字段最大大小
    fields: 1000                  // 最大字段数量，避免字段过多触发限制
  }
});

另外，部分特殊格式文件（如rar）的头部结构可能被Busboy的解析逻辑误判为异常，导致提前终止。

2. 反向代理/中间件的超时或大小限制 #

如果 Node.js 服务器前端部署了 Nginx、Apache 或云服务商的负载均衡，这些组件可能独立设置了超时和请求体大小限制：

• 比如 Nginx 的 proxy_read_timeout 会限制后端响应等待时间，client_max_body_size 限制请求体总大小；
• 云负载均衡可能有默认的连接超时配置。
  需要检查这些中间件的配置，确保超时时间覆盖上传所需时长，且允许的请求体大小足够容纳目标文件。

3. 流处理异常未被捕获 #

Busboy 基于 Node.js 流实现文件解析，若流处理过程中出现错误（如磁盘写入失败、内存不足、权限问题），会直接中断上传。需确保监听 Busboy 的error事件，避免未捕获错误导致连接异常断开：

busboy.on('error', (err) => {
  console.error('Busboy 解析错误:', err);
  req.unpipe(busboy);
  // 返回前端明确的错误响应，避免连接异常中断
  res.writeHead(500, { 'Content-Type': 'text/plain' });
  res.end('上传解析失败');
});

同时检查文件写入目录的权限、磁盘剩余空间，这些都可能导致写入失败触发中断。

4. 前端 XMLHttpRequest 的超时设置 #

前端的 XMLHttpRequest 可能设置了timeout属性，若上传耗时超过该值，前端会主动中断请求。检查前端代码：

// 若存在此类配置，调整为更大值或设为0（无超时）
xhr.timeout = 0;

5. Node.js v18 新增的 idleTimeout 未禁用 #

Node.js v18 新增了server.idleTimeout配置（默认30秒），若上传过程中数据流出现短暂停滞，可能被判定为空闲连接而断开。尝试禁用该配置：

server.idleTimeout = 0;

6. 文件格式触发的解析异常 #

不同扩展名的文件结构差异可能导致 Busboy 解析异常：

• 比如 rar 文件的压缩包头部包含特殊字节序列，可能触发 Busboy 的异常检测；
• msi 文件的数据流结构可能让解析过程更稳定，所以中断节点更靠后。
  可以尝试绕过 Busboy，直接将请求流写入文件，验证是否是解析层面的问题：

const fs = require('fs');
const writeStream = fs.createWriteStream('./test-file');
req.pipe(writeStream);
writeStream.on('finish', () => console.log('文件写入完成'));
writeStream.on('error', (err) => console.error('写入错误:', err));

如果这种方式能完成上传，说明问题出在 Busboy 的解析逻辑上，可尝试升级 Busboy 或调整其解析配置。

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