Node.js中POST请求req.body值未定义问题求助

这个问题我之前也碰到过，大概率是Express没有配置JSON请求体解析中间件，或者前端请求的格式不对导致的，咱们一步步来排查解决：

第一步：检查Express后端的中间件配置 #

Express默认不会自动解析JSON格式的请求体，所以必须手动添加express.json()中间件，而且要确保它在你的路由定义之前加载——这是最常见的坑！

修正后的后端示例代码： #

const express = require('express');
const mongoose = require('mongoose'); // 假设你用了mongoose连接MongoDB
const app = express();

// 关键！必须在路由之前添加这个中间件，解析JSON请求体
app.use(express.json());

// 如果你需要处理表单格式的请求（比如x-www-form-urlencoded），可以再加这个
app.use(express.urlencoded({ extended: true }));

// 连接MongoDB的代码（略）
mongoose.connect('你的MongoDB连接字符串')
  .then(() => console.log('MongoDB连接成功'))
  .catch(err => console.error('连接失败', err));

// 你的POST路由
app.post('/api/your-endpoint', async (req, res) => {
  try {
    console.log('收到的请求体：', req.body); // 现在应该能正常打印数据了
    // 硬编码能成功，说明MongoDB操作没问题，现在用req.body的数据插入
    const newDoc = await YourModel.create(req.body);
    res.status(201).json(newDoc);
  } catch (err) {
    res.status(400).json({ error: err.message });
  }
});

const PORT = process.env.PORT || 5000;
app.listen(PORT, () => console.log(`服务器运行在端口${PORT}`));

第二步：检查前端React的请求格式 #

前端提交数据时，必须确保两个关键点：

1. 请求头设置Content-Type: application/json
2. 把JS对象序列化为JSON字符串（用JSON.stringify()）

用fetch的前端示例： #

const handleSubmit = async (e) => {
  e.preventDefault();
  const formData = {
    // 你的表单数据，比如name, email等
    name: '测试数据',
    email: 'test@example.com'
  };

  try {
    const response = await fetch('http://localhost:5000/api/your-endpoint', {
      method: 'POST',
      headers: {
        'Content-Type': 'application/json', // 必须设置这个！
      },
      body: JSON.stringify(formData), // 把JS对象转成JSON字符串
    });

    if (!response.ok) throw new Error('请求失败');
    const result = await response.json();
    console.log('插入成功：', result);
  } catch (err) {
    console.error('错误：', err.message);
  }
};

用axios的前端示例（更简单）： #

axios默认会自动设置Content-Type: application/json，并且自动序列化请求体，所以代码更简洁：

import axios from 'axios';

const handleSubmit = async (e) => {
  e.preventDefault();
  const formData = {
    name: '测试数据',
    email: 'test@example.com'
  };

  try {
    const response = await axios.post('http://localhost:5000/api/your-endpoint', formData);
    console.log('插入成功：', response.data);
  } catch (err) {
    console.error('错误：', err.response.data.error);
  }
};

第三步：验证请求是否正确到达服务器 #

如果还是有问题，可以用工具先单独测试后端接口，排除前端的干扰：

• 用Postman：新建POST请求，设置Headers为Content-Type: application/json，Body选raw-JSON，输入测试数据发送，看后端控制台是否能打印出req.body。
• 用curl命令：

curl -X POST -H "Content-Type: application/json" -d '{"name":"测试","email":"test@example.com"}' http://localhost:5000/api/your-endpoint

如果后端能正常接收数据，说明问题出在前端；如果还是undefined，那再检查后端中间件的顺序（必须在路由之前）。

额外注意：跨域问题 #

如果你的React前端和Express后端运行在不同端口（比如前端3000，后端5000），还需要配置CORS中间件，否则请求可能被浏览器拦截：

const cors = require('cors');
app.use(cors()); // 放在express.json()之后，路由之前

按照这个步骤排查，应该就能解决req.body undefined的问题了！

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