Node.js(Express)自有服务器向第三方API传文件报错排查

你遇到的问题核心是直接将Multer解析后的req.file对象作为请求体发送给第三方API是错误的——req.file是Multer解析后生成的元数据+文件buffer的组合，并不是符合multipart/form-data格式的请求体，这也是第三方API报错的根本原因。

为什么当前代码不对？ #

1. 手动设置headers: { "Content-Type": "multipart/form-data" }无效：multipart/form-data请求必须包含boundary分隔符（用来区分表单中的不同字段），手动设置这个头会丢失boundary信息，导致第三方API无法解析请求。
2. req.file不是标准表单数据：它是一个包含buffer、mimetype等属性的对象，直接作为请求体发送，第三方API收到的不是预期的文件表单结构。

解决方案一：重新构建FormData并转发（适合需要先处理文件的场景） #

Node.js环境没有浏览器原生的FormData，需要先安装form-data包：

npm install form-data

修改服务器路由代码，重新构建符合要求的表单数据，并让form-data包自动生成正确的请求头：

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

app.post("/attachment", multer().single("file"), async (req, res) => { 
  try {
    const formData = new FormData();
    // 将文件buffer、原始文件名、mimetype添加到FormData中
    formData.append('file', req.file.buffer, {
      filename: req.file.originalname,
      contentType: req.file.mimetype
    });

    const response = await fetch("http://expternal-api.com/rest/api/attachments", { 
      method: "POST", 
      body: formData,
      // 使用form-data自动生成的headers，包含正确的boundary
      headers: formData.getHeaders()
    });

    // 处理第三方API的响应
    const result = await response.json();
    res.json(result);
  } catch (err) {
    console.error(err);
    res.status(500).json({ error: '转发文件失败' });
  }
});

解决方案二：直接转发原始请求体（适合无需处理文件，仅转发的场景） #

如果你的服务器不需要解析文件，只是做中转，可以跳过Multer解析，直接将原始请求体管道到第三方API，这样能完全保留客户端发送的multipart/form-data格式，效率更高：

app.post("/attachment", async (req, res) => { 
  try {
    const response = await fetch("http://expternal-api.com/rest/api/attachments", { 
      method: "POST", 
      body: req,
      // 转发客户端的Content-Type头（包含正确的boundary）
      headers: {
        ...req.headers,
        // 如果第三方API需要身份验证等其他头，在这里补充
      }
    });

    const result = await response.json();
    res.json(result);
  } catch (err) {
    console.error(err);
    res.status(500).json({ error: '转发文件失败' });
  }
});

额外注意点 #

• 原代码的then链存在逻辑问题：第一个.then((res) => console.log(res))没有返回值，导致第二个.then((result) => res.json(result))中的result是undefined，改用async/await写法更易维护和排查错误。
• 确认第三方API的接口字段名和你发送的一致（比如你用file作为字段名，要确保第三方API也接受这个字段名）。

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