Express.js使用form-data时req.body为空的问题求助

• Express 内置的express.json()和express.urlencoded()仅支持解析application/json和application/x-www-form-urlencoded格式的请求体，完全不兼容multipart/form-data（即Postman中的form-data模式），因此用该格式发送请求时，req.body会是空对象。
• 你代码中重复引入了body-parser，但它的urlencoded方法同样无法处理multipart/form-data；且Express 4.16+已内置body-parser的核心功能，重复引入属于冗余操作。

1. 安装multer中间件 #

multer是Express生态中专门用于处理multipart/form-data的中间件，先执行安装命令：

npm install multer

2. 配置multer并应用 #

方式一：全局配置（所有接口都能处理form-data） #

修改index.js的中间件配置：

require("dotenv").config();
const express = require("express");
const server = express();
const cors = require("cors");
const port = process.env.PORT || 3000;
// 引入并配置multer
const multer = require("multer");
const storage = multer.memoryStorage(); // 不保存文件，仅解析字段
const upload = multer({ storage: storage });

// 数据库连接
require("./db/conn");

// 中间件配置
server.use(express.json());
server.use(cors());
// 移除重复的body-parser相关代码
// 使用multer处理所有请求的form-data
server.use(upload.any());

// 路由挂载
const userRouter = require("./routes/UserRoutes");
const authRouter = require("./routes/AuthRouter");
server.use("/user", userRouter);
server.use("/auth", authRouter);

server.listen(port, () => {
  console.log(`server started at http://localhost:${port}`);
});

方式二：仅在需要的路由配置（更灵活） #

如果只有部分接口需要处理form-data，可在路由文件中单独配置：
修改路由文件（如AuthRouter.js）：

const express = require("express");
const router = express.Router();
const multer = require("multer");
const upload = multer(); // 默认配置，仅解析字段
const { Auth } = require("../middlewares/auth");
const {
  Login,
  UpdateUser,
  Dashboard,
  Register,
  Posts,
} = require("../controllers/UserController");

// 在需要处理form-data的路由前添加upload.none()（适用于仅传字段、无文件的场景）
router.post("/register", upload.none(), Register);
router.post("/login", upload.none(), Login);
router.put("/update/:id", upload.none(), Auth, UpdateUser);
router.get("/dashboard", Auth, Dashboard);
router.get("/getposts", Auth, Posts);

module.exports = router;

3. 额外注意事项 #

• 若form-data中包含文件上传，不要使用upload.none()，需改用upload.single('fileFieldName')（单文件）或upload.array('fileFieldName', maxCount)（多文件）。
• 彻底移除代码中重复的body-parser引入与调用，避免潜在的中间件冲突。

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