使用Axios向第三方API传文件及元数据遇参数缺失错误求助

你的问题出在表单数据构造方式和请求头设置上：第三方API期望fileName和fileExt是form-data中的顶层字段，而非嵌套在JSON字符串里；同时手动设置Content-Type会丢失关键的边界标识，导致API无法解析表单内容。

步骤1：安装依赖 #

Node.js环境下需要用form-data包正确构造multipart/form-data请求，先执行安装：

npm install form-data

步骤2：修正后的代码 #

const fs = require('fs');
const axios = require('axios');
const FormData = require('form-data');

// createReadStream是同步方法，无需await
const fileMedia = fs.createReadStream(fileName);
const formData = new FormData();

// 追加文件流到表单
formData.append('file', fileMedia);
// 直接追加API要求的元数据字段（不要打包成JSON）
formData.append('fileName', file.fileName);
formData.append('fileExt', file.fileExt);

const response = await axios.post(
  `${process.env.CCR_LOGIN_URL}/start/multipart`,
  formData,
  {
    headers: {
      Authorization: admin_token_ccr,
      // 用form-data自动生成的请求头，包含正确的boundary
      ...formData.getHeaders()
    },
    // 适配5GB大文件上传的配置
    timeout: 0, // 取消超时限制
    maxContentLength: Infinity,
    maxBodyLength: Infinity
  }
);

关键修正说明 #

1. 表单字段结构：将fileName和fileExt作为独立字段添加到FormData，完全匹配API对参数位置的要求（错误提示明确这两个参数需在body顶层）。
2. 请求头处理：不再手动设置Content-Type: multipart/form-data，而是通过formData.getHeaders()获取包含自动生成边界（boundary）的请求头，这是第三方API能正确解析表单的核心。
3. 大文件适配：取消超时限制并设置无限内容长度，避免Axios因大文件上传触发超时或大小限制错误。
4. 同步方法修正：fs.createReadStream是同步方法，不需要用await包裹。

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