Express中POST请求req.body为空的问题排查求助

问题场景 #

开发Express用户注册功能时，向/api/user/发送POST请求，在userControllers.js中通过console.log("req", req.body)打印请求体，结果得到空对象{}。已确认Postman发送的数据格式合法，控制器、路由、模型文件配置均无明显错误，但始终无法获取请求体数据。

相关代码文件 #

userModel.js #

const mongoose = require("mongoose");

const userSchema = mongoose.Schema(
  {
    name: { type: String, required: true },
    email: { type: String, unique: true, required: true },
    password: { type: String, required: true },
    pic: {
      type: String,
      required: true,
      default: "https://icon-library.com/images/anonymous-avatar-icon/anonymous-avatar-icon-25.jpg",
    },
  },
  {
    versionKey: false,
    timestamps: true,
  }
);

const User = mongoose.model("User", userSchema);

module.exports = User;

userControllers.js #

const User = require("../models/userModel");
const asyncHandler = require("express-async-handler");
const generateToken = require("../config/generateToken");

const registerUser = asyncHandler(async (req, res) => {
  console.log("req", req.body);
  const { name, email, password, pic } = req.body;

  if (!name || !email || !password) {
    return res.status(400).json({ error: "Please Enter all the Fields" });
  }

  const userExists = await User.findOne({ email });

  if (userExists) {
    return res.status(400).json({ error: "User already exists" });
  }

  const user = await User.create({
    name,
    email,
    password,
    pic,
  });

  if (user) {
    return res.status(201).json({
      _id: user._id,
      name: user.name,
      email: user.email,
      pic: user.pic,
      token: generateToken(user._id),
    });
  } else {
    return res.status(400).json({ error: "User creation failed" });
  }
});

module.exports = { registerUser };

userRoutes.js #

const express = require("express");
const { registerUser } = require("../controllers/userControllers");

const router = express.Router();

router.route("/").post(registerUser);

module.exports = router;

server.js #

const express = require("express");
const connectDB = require("./config/db");
const dotenv = require("dotenv");
const userRoutes = require("./routes/userRoutes");
const path = require("path");

dotenv.config();
connectDB();
const app = express();

app.use(express.json()); // 用于解析JSON格式请求体

app.use("/api/user", userRoutes);

const PORT = process.env.PORT;

const server = app.listen(
  PORT,
  console.log(`Server running on PORT ${PORT}...`.yellow.bold)
);

发送的数据格式 #

{
  "name": "John Doe",
  "email": "john@gmail.com",
  "password": "securepassword"
}

排查与解决步骤 #

1. 检查Postman请求头配置

   • 确保请求头中Content-Type设置为application/json，express.json()仅能解析该格式的请求体；若使用form-data或x-www-form-urlencoded格式，需对应添加express.urlencoded()等中间件。
   • 确认Postman的Body选择raw且格式为JSON，而非其他类型。

2. 验证中间件加载顺序

   • app.use(express.json())必须在路由注册app.use("/api/user", userRoutes)之前加载，否则路由无法使用该中间件解析请求体。当前代码顺序正确，后续调整代码时需注意此规则。

3. 排除工具配置问题

   • 使用curl发送测试请求，验证是否为Postman配置导致的问题：

     curl -X POST http://localhost:你的端口/api/user \
     -H "Content-Type: application/json" \
     -d '{"name":"John Doe","email":"john@gmail.com","password":"securepassword"}'
     

   • 查看服务器控制台是否能正确打印req.body。

4. 检查Express版本兼容性

   • 确保使用的Express版本在4.16.0及以上，该版本开始内置express.json()替代了原body-parser的json()方法，低版本可能存在解析问题。

5. 确认请求URL正确性

   • 确保请求URL为/api/user（无多余斜杠或拼写错误），若URL不匹配，请求可能被路由到未配置解析中间件的路径，导致req.body为空。

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