Express框架之req.body获取数据问题分析及解决办法

在 Express.js 中解析请求体数据时的常见问题

Express.js 是一个轻量级的 Web 应用程序框架，可简化应用程序开发和部署。在使用 Express.js 时，获取请求体数据时可能会遇到一些问题。本文将深入探讨这些问题，并提供切实可行的解决方案。

问题 1：未安装 Body-Parser 中间件

Express.js 框架本身没有解析请求体的功能。您需要安装 body-parser 中间件来解析请求体中的数据。如果未安装此中间件，则 Express.js 无法解析请求体中的数据，导致 req.body 为空对象。

解决方案：

使用以下命令安装 body-parser 中间件：

npm install body-parser --save

然后在您的 Express.js 应用程序中使用它：

const bodyParser = require('body-parser');
app.use(bodyParser.json()); // 解析 JSON 格式的请求体
app.use(bodyParser.urlencoded({ extended: false })); // 解析 URL 编码格式的请求体

问题 2：未正确设置 Content-Type 请求头

发送请求时，必须在请求头中设置 Content-Type 头，以指定请求体的格式。如果 Content-Type 头设置不正确，Express.js 框架将无法正确解析请求体中的数据，从而导致 req.body 为空对象。

解决方案：

如果使用 JSON 格式发送数据，请将 Content-Type 头设置为：

Content-Type: application/json

如果使用表单提交发送数据，请将 Content-Type 头设置为：

Content-Type: application/x-www-form-urlencoded

问题 3：Express.js 版本低于 4.16.0

在 Express.js 4.16.0 之前的版本中，默认情况下 req.body 是不可用的。您需要使用 express.json() 或 express.urlencoded() 中间件来启用 req.body。

解决方案：

将 Express.js 升级到 4.16.0 或更高版本：

npm install express@4.16.0 --save

问题 4：未启用 Strict Mode

在 Express.js 4.16.0 及更高版本中，默认情况下禁用了 Strict Mode。如果您在解析请求体数据时遇到问题，则可以启用 Strict Mode 来强制执行更严格的数据类型检查。

解决方案：

在您的 Express.js 应用程序中启用 Strict Mode：

app.set('strict routing', true);
app.set('strict query parsing', true);

常见问题解答

问： 为什么 req.body 为空，即使我已安装了 body-parser？
答： 请确保您已在应用程序中使用 body-parser 中间件。

问： 我收到 "TypeError: 无法读取 undefined 的 'map'" 错误。如何解决？
答： 确保请求体包含有效的 JSON 数据，并且 Content-Type 头已正确设置为 "application/json"。

问： 如何解析 URL 编码的请求体？
答： 使用 bodyParser.urlencoded({ extended: false }) 中间件来解析 URL 编码的请求体。

问： 如何启用 Strict Mode？
答： 在您的应用程序中设置 app.set('strict routing', true) 和 app.set('strict query parsing', true)。

问： Express.js 是否支持 GraphQL？
答： 是的，Express.js 支持 GraphQL。您可以使用 Apollo Server 等第三方库来实现 GraphQL。

总结

本文介绍了在使用 Express.js 获取请求体数据时可能遇到的常见问题，并提供了相应的解决方案。通过遵循这些解决方案，您可以确保 Express.js 框架能够正确解析请求体中的数据，从而使您的 Web 应用程序正常运行。