You need to enable JavaScript to run this app. React通过axios发FormData至Node.js后端req.body为空,发JSON正常求助
优惠活动
大模型
产品
解决方案
定价
更多

React通过axios发FormData至Node.js后端req.body为空,发JSON正常求助

核心根因
  • 后端仅通过express.json()配置了JSON格式请求体的解析能力,该中间件仅能识别Content-Type为application/json的请求内容,这也是直接传普通JSON对象时后端可正常读取req.body的原因。
  • 通过new FormData()构造请求体发送时,axios会自动将请求Content-Type设置为multipart/form-data,这类格式的请求体不在express.json()的解析范围内,因此后端无法将内容写入req.body,最终拿到空对象。
解决方法

方案一:无文件上传场景,直接改用JSON提交

如果表单只传文本字段,完全不需要用FormData,直接适配现有后端配置即可,仅需修改前端提交逻辑:

handlerLogin = (e) => {
    e.preventDefault();
    // 直接从组件状态取值构造JSON payload
    const payload = { phone, password };
    axios.post('http://localhost:5000/api/test/', payload);
}

该逻辑和你测试普通JSON对象的行为完全一致,后端无需任何改动。

方案二:需要用FormData提交(含文件/特殊表单格式需求)

需要给后端新增multipart/form-data格式的解析能力,以常用的multer中间件为例:

  1. 安装依赖:npm install multer
  2. 在后端入口文件中引入并配置,注意中间件挂载顺序要早于业务路由:
const express = require('express');
const cors = require('cors');
const multer = require('multer');
const config = require('config');
const testRoutes = require('./routes/test');

const app = express();
const PORT = config.get('port') || 5000;
const upload = multer(); // 初始化解析器

app.use(cors());
app.use(express.json({ extended: true }));
// 解析纯文本类型的FormData请求(不含文件时用none()方法即可)
app.use(upload.none());

app.use('/api/test', testRoutes);

app.listen(PORT, () => console.log(`Сервер запустился на порте ${PORT}`));
  1. 配置完成后,原FormData的提交逻辑即可正常在req.body中读取到所有表单字段。

注意避坑

不要手动为axios设置FormData请求的Content-Type头,手动配置会丢失请求头中必要的boundary分隔符,反而会导致后端解析失败,交由浏览器/axios自动生成请求头即可。


内容的提问来源于stack exchange,提问作者Sardor

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.10.22 14:15:03