当前位置：首页 > news >正文

body-parser 与 express.json()、express.urlencoded() 会冲突

news 来源：原创 2025/5/25 18:43:56

说明

body-parser 与 express.json()

body-parser 和 express.json() 主要用于解析请求体中的 JSON 数据。

express.json() 和 express.urlencoded() 已经内置了 body-parser 的功能，不需要再额外使用 body-parser。

bodyParser.urlencoded({ extended: false }) 和 express.urlencoded({ extended: true }) 会导致配置冲突。

即：

app.use(express.json());
app.use(express.urlencoded({ extended: true }));     // 冲突
app.use(bodyParser.urlencoded({ extended: false })); // 冲突（删除）
app.use(bodyParser.json());                          // 删除

把 body-parser 相关的代码删除，直接使用 express 提供的解析方法：

app.use(express.json());  
app.use(express.urlencoded({ extended: true }));

body-parser

body-parser 是一个独立的中间件，专门用于解析 HTTP 请求体。它提供多种解析方式；

bodyParser.json() 解析 JSON 格式的数据
bodyParser.urlencoded({ extended: true }) 解析 application/x-www-form-urlencoded 数据
bodyParser.text() 解析文本格式数据
bodyParser.raw() 解析 Buffer 格式的数据

在 Express 4.x 之前，开发者需要单独安装 body-parser，然后在 Express 代码中使用：

const express = require('express');
const bodyParser = require('body-parser');

const app = express();
app.use(bodyParser.json());
app.use(bodyParser.urlencoded({ extended: true }));

app.post('/data', (req, res) => {
  console.log(req.body);
  res.send('Received');
});

app.listen(3000, () => console.log('Server running on port 3000'));

express.json()

从 Express 4.16.0 版本开始，express.json() 和 express.urlencoded() 直接内置于 express，不再需要单独安装 body-parser。

使用 express.json() 代替 bodyParser.json()：

const express = require('express');

const app = express();
app.use(express.json());  // 解析 JSON 数据
app.use(express.urlencoded({ extended: true }));  // 解析 URL 编码数据

app.post('/data', (req, res) => {
  console.log(req.body);
  res.send('Received');
});

app.listen(3000, () => console.log('Server running on port 3000'));

body-parser 和 express.json() 主要用于解析请求体中的 JSON 数据，区别如下：

1. body-parser

body-parser 是一个独立的中间件，专门用于解析 HTTP 请求体。它提供多种解析方式，例如：

bodyParser.json() 解析 JSON 格式的数据
bodyParser.urlencoded({ extended: true }) 解析 application/x-www-form-urlencoded 数据
bodyParser.text() 解析文本格式数据
bodyParser.raw() 解析 Buffer 格式的数据

在 Express 4.x 之前，开发者需要单独安装 body-parser：

npm install body-parser

然后在 Express 代码中使用：

const express = require('express');
const bodyParser = require('body-parser');

const app = express();
app.use(bodyParser.json());
app.use(bodyParser.urlencoded({ extended: true }));

app.post('/data', (req, res) => {
  console.log(req.body);
  res.send('Received');
});

app.listen(3000, () => console.log('Server running on port 3000'));

3. 区别

特性	`body-parser`	`express.json()`
是否需要安装	需要 (`npm install body-parser`)	不需要，内置于 Express 4.16+
用法	`bodyParser.json()`	`express.json()`
功能	提供 JSON、URL 编码、文本、原始数据解析	仅提供 JSON 和 URL 编码解析
推荐使用	仅在 Express 4.16 之前	Express 4.16 及以上推荐使用

结论

如果你使用的是 Express 4.16+，直接使用 express.json() 和 express.urlencoded() 即可，无需 body-parser。
如果你需要 解析文本 或 原始 Buffer 数据，仍然可以使用 body-parser.text() 和 body-parser.raw()。

在大多数情况下，express.json() 足够满足需求，推荐优先使用它。