OkHttp+Node.js Formidable大文件上传失败求助：超100MB文件上传中断

看起来你遇到的是大文件上传到Formidable服务端时进度卡在99%后中止的典型问题，我之前处理过类似场景，给你几个排查和解决的方向：

1. 先检查Formidable的文件大小限制 #

Formidable默认对单个文件和总请求大小有严格限制，超过阈值会直接截断请求，这很可能是你遇到的核心问题。在初始化Formidable时，显式设置更大的限制：

const formidable = require('formidable');
const form = formidable({
  maxFileSize: 200 * 1024 * 1024, // 单个文件最大200MB
  maxTotalFileSize: 200 * 1024 * 1024, // 总上传大小限制
  keepExtensions: true
});

另外，别忘了监听Formidable的error事件，它会告诉你具体的超限或异常信息：

form.on('error', (err) => {
  console.error('Formidable处理出错:', err.message);
});

2. 调整Node.js HTTP服务器的超时设置 #

不管你用原生HTTP还是Express，默认的请求超时时间都比较短（通常2分钟），大文件上传很容易触发超时中断。修改服务器超时：

// 原生HTTP服务器
const http = require('http');
const server = http.createServer(/* 处理逻辑 */);
server.timeout = 300000; // 设置为5分钟（300秒）

// Express框架
const express = require('express');
const app = express();
const server = app.listen(3000);
server.timeout = 300000;

关键提醒：如果你的Express项目中使用了express.json()或express.urlencoded()中间件，一定要在Formidable处理的路由之前禁用它们！这些中间件会提前读取请求体，导致Formidable无法获取完整的文件数据，直接中断上传流程。

3. OkHttp端的超时与上传配置优化 #

确保OkHttp的各类超时时间足够长，并且采用流式上传（避免把大文件加载到内存导致异常）：

OkHttpClient client = new OkHttpClient.Builder()
    .callTimeout(5, TimeUnit.MINUTES)
    .connectTimeout(5, TimeUnit.MINUTES)
    .readTimeout(5, TimeUnit.MINUTES)
    .writeTimeout(5, TimeUnit.MINUTES) // 写超时对大文件上传至关重要
    .retryOnConnectionFailure(false) // 禁用连接失败重试，避免重复上传引发异常
    .build();

// 构建Multipart请求时，确保用File作为RequestBody的数据源（流式上传）
RequestBody fileBody = RequestBody.create(MediaType.parse("application/octet-stream"), new File("/path/to/large/file"));
MultipartBody requestBody = new MultipartBody.Builder()
    .setType(MultipartBody.FORM)
    .addFormDataPart("file", "large-file.ext", fileBody)
    .build();

4. 排查反向代理/网关的限制 #

如果你的Node.js服务前面有Nginx或其他反向代理，一定要检查这些配置：

• Nginx的client_max_body_size：默认只有1MB，必须设置成大于你的文件大小，比如：

  http {
      client_max_body_size 200M;
      server {
          proxy_connect_timeout 300s;
          proxy_send_timeout 300s;
          proxy_read_timeout 300s;
          # 其他配置...
      }
  }
  

• 云服务的负载均衡/WAF：有些云厂商的负载均衡默认有请求超时或大小限制，需要在控制台调整对应参数。

5. 监听Formidable的aborted事件定位原因 #

除了error事件，Formidable的aborted事件能帮你捕捉请求中止的场景，结合日志更容易定位问题根源：

form.on('aborted', () => {
  console.log('上传请求被中止，可能的原因：客户端断开、超时或服务器限制');
});

按照这个顺序排查，大概率能解决你的问题——我之前遇到的类似情况就是因为Nginx的client_max_body_size太小，导致文件传到99%被截断，调整后就恢复正常了。

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