使用axios发送multipart/form-data请求时body为空如何解决

问题产生原因 #

• 手动硬编码了multipart/form-data的boundary参数：FormData实例在构建时会自动生成唯一的边界分隔符，你手动指定的boundary=CSC和实际FormData使用的分隔符不一致，服务端收到请求后无法正确拆分form字段，最终解析出的Body为空。
• Node.js环境下未正确配置axios的FormData传输逻辑：浏览器端axios会自动识别FormData类型并适配请求头，但Node.js环境需要手动传入FormData实例生成的请求头配置，否则无法正确序列化数据。
• 文件上传参数错误：当前AnexoConteudo字段传入的是本地文件路径字符串，而非文件的二进制流/Buffer，无法实现.txt/.msg格式文件的上传需求。
• 缺少FormData依赖：Node.js原生没有内置FormData实现，若未安装form-data第三方包也会导致数据构造异常。

修复步骤 #

1. 移除手动写死的Content-Type请求头，改用FormData实例自动生成的头信息，避免boundary不匹配问题
2. 安装form-data依赖，用fs模块正确读取本地文件为可读流传入FormData
3. 调整axios请求配置，适配Node.js环境下的FormData传输

修改后代码 #

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

async function UploadFile(urlNovaTarefa, siteUrl, clientId, clientSecret, nomeCentral, grupoId, AssuntoId, usuario, solicitante, copia, solicitacao, anexoNome, anexoConteudo, dataEntrada, enviarNotificacao, cnpjPedido, responsavel){
    const form = new FormData();
    form.append('NomeCentral', nomeCentral);
    form.append('GrupoId', grupoId);
    form.append('AssuntoId', AssuntoId);
    form.append('Usuario', usuario);
    form.append('Solicitante', solicitante);
    form.append('Copia', copia); 
    form.append('Solicitacao', solicitacao);
    form.append('AnexoNome', anexoNome);
    // 读取文件为流传入，而非传路径字符串
    form.append('AnexoConteudo', fs.createReadStream(anexoConteudo));
    form.append('DataEntrada', dataEntrada);
    form.append('EnviarNotificacao', enviarNotificacao);
    form.append('CNPJPedido', cnpjPedido);
    form.append('Responsavel', responsavel);

    let response = await axios.post(urlNovaTarefa, form, {
          headers: {
            'SiteUrl': siteUrl,
            'Client-Id': clientId,
            'Client-Secret': clientSecret,
            // 合并FormData自动生成的头（含正确的boundary）
            ...form.getHeaders(),
            'Access-Control-Allow-Origin': "*",
          },
          // 避免axios默认序列化FormData数据
          transformRequest: [data => data]
        });

        let data = response.data;
        console.log(data);
  }


  UploadFile("https://example.net/ct/csc/novaTarefa", "https://example.com/sites/centralcsc/", "1234-1234-1234-1234", "abcd-abcd-abcd-abcd=", "ServicosClientes", "4", "3", "email@example.com", "email@example.com", "email@example.com", "Test", "Test.txt", "C:\\Users\\User\\Desktop\\Test.txt", "07/10/2021 14:30", "N", "[{\"NumeroCNPJ\":\"12345678910112\",\"NumeroPedido\":[]}]", "email@example.com")
  .then(response => console.log(response))
  .catch(err => console.log(err))

验证方法 #

修改完成后先测试普通字段是否能正常被服务端接收，再验证文件上传功能。如果仍有问题可通过抓包工具查看实际发送的请求内容，确认form字段和boundary是否匹配。

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