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中间件为例:
- 安装依赖:
npm install multer - 在后端入口文件中引入并配置,注意中间件挂载顺序要早于业务路由:
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}`));
- 配置完成后,原FormData的提交逻辑即可正常在
req.body中读取到所有表单字段。
注意避坑
不要手动为axios设置FormData请求的Content-Type头,手动配置会丢失请求头中必要的boundary分隔符,反而会导致后端解析失败,交由浏览器/axios自动生成请求头即可。
内容的提问来源于stack exchange,提问作者Sardor
相关产品推荐
相关产品推荐

