Node.js中使用Express Router时无法集成body-parser的问题解决

问题根源 #

你的代码仅引入了body-parser，但未挂载解析请求体的中间件，导致req.body无法被正确解析；另外如果直接将对象作为字符串输出响应，也会出现[object Object]的显示问题。

修复步骤 #

1. 优先使用Express内置解析功能（推荐）

Express 4.16.0及以上版本已内置body-parser核心功能，无需单独安装body-parser包，直接使用express.json()和express.urlencoded()即可。

2. 挂载解析中间件

两种挂载方式二选一即可：

• 全局挂载（所有路由生效）：在项目入口文件（如app.js）中添加：

  const express = require('express');
  const app = express();
  const apiRouter = require('./routes/api.router');
  
  // 解析JSON格式请求体
  app.use(express.json());
  // 解析URL编码的表单数据（extended: true支持复杂嵌套结构）
  app.use(express.urlencoded({ extended: true }));
  
  // 挂载API路由
  app.use('/api', apiRouter);
  
  app.listen(3000, () => console.log('服务运行在3000端口'));
  

• 仅给当前路由挂载：若只想让API路由使用解析功能，修改api.router.js：

  const express = require('express');
  const apiController = require('../controllers/api.controller');
  const router = express.Router();
  
  // 给当前路由添加解析中间件
  router.use(express.json());
  router.use(express.urlencoded({ extended: true }));
  
  router.post('/new', apiController.addUser);
  module.exports = router;
  

3. 检查请求的Content-Type

前端发送请求时，必须匹配对应Content-Type：

• 发送JSON数据时，设置Content-Type: application/json
• 发送表单数据时，设置Content-Type: application/x-www-form-urlencoded
  若Content-Type不匹配，中间件会跳过解析，req.body会是空对象或undefined。

4. 避免直接输出对象为字符串

如果错误出现在响应环节，大概率是用了res.send(req.body)，对象被强制转为字符串导致显示[object Object]。改用res.json()返回JSON格式响应：

// 在api.controller.js中修改响应逻辑
const addUser = async (req, res) => {
  const { firstName, lastName, age } = req.body;
  console.log(req.body);
  // 正确返回JSON格式响应
  res.json({ success: true, data: req.body });
};

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