本文详解 Express 应用中 POST 请求接收不到 req.body（返回空对象 {} 或 400 错误）的根本原因，涵盖中间件配置、路由注册、请求头设置及数据校验等关键环节，并提供可直接运行的修复代码与最佳实践。
本文详解 express 应用中 post 请求接收不到 `req.body`（返回空对象 `{}` 或 400 错误）的根本原因，涵盖中间件配置、路由注册、请求头设置及数据校验等关键环节，并提供可直接运行的修复代码与最佳实践。
在 Express 中，req.body 为空（{}）或触发 400 错误，绝非偶然现象，而是由请求体解析中间件缺失、配置时机错误或客户端发送格式不匹配导致的系统性问题。你提供的代码中看似调用了 routerStories.use(express.json())，但该配置存在严重隐患——它仅作用于当前 Router 实例，且未覆盖 urlencoded 格式；更重要的是，中间件必须在路由定义前全局或正确挂载，否则对所有 POST 请求均失效。
✅ 正确配置请求体解析中间件（关键第一步）
Express 默认不自动解析请求体。需显式启用以下两类中间件（缺一不可）：
const express = require('express');
const app = express();
// ✅ 必须在所有路由前注册，且顺序重要：先 json，再 urlencoded
app.use(express.json({ limit: '10mb' })); // 解析 application/json
app.use(express.urlencoded({ extended: true, limit: '10mb' })); // 解析 application/x-www-form-urlencoded（含表单、Axios默认格式）
// ❌ 错误示例：仅在 Router 上 use，且遗漏 urlencoded
// routerStories.use(express.json()); // → 无效！Router.use 不影响父级解析逻辑⚠️ 注意：express.json() 仅处理 Content-Type: application/json 请求；若前端用 axios.post(url, data)（默认 application/json）则需此中间件；若用 FormData 或 HTML 表单，则必须启用 express.urlencoded()。
✅ 正确定义与挂载 Router（避免路由冲突）
你代码中 routerStories.post('/', ...) 可能与主应用其他路由冲突（如 / 已被其他 app.post('/') 占用），且未将 Router 挂载到主应用：
// books.js 示例（修正导入方式）
// export const infoBooks = { stories: [] };
const { infoBooks } = require('../data/books.js');
// 路由文件（routes/stories.js）
const express = require('express');
const router = express.Router(); // 使用标准命名，避免混淆
// ✅ 在 Router 内部无需重复 use() —— 中间件已在 app 层统一配置
router.post('/create', (req, res) => {
const newBook = req.body;
// ✅ 强制数据校验（防御性编程）
if (!newBook || typeof newBook !== 'object' || Object.keys(newBook).length === 0) {
return res.status(400).json({
error: 'Invalid request body: expected a non-empty JSON object'
});
}
infoBooks.stories.push(newBook);
res.status(201).json({
message: 'Book added successfully',
data: infoBooks.stories
});
});
module.exports = router;并在主应用（如 app.js）中正确挂载：
const storiesRouter = require('./routes/stories');
app.use('/api/stories', storiesRouter); // ✅ 挂载路径前缀，避免根路径冲突✅ 客户端请求必须匹配服务端配置
确保前端请求头与中间件严格对应：
| 客户端发送方式 | 必需中间件 | Content-Type Header |
|---|---|---|
| fetch(url, { method: 'POST', body: JSON.stringify(data) }) | express.json() | 'application/json' |
| axios.post(url, data) | express.json() | 自动设置为 'application/json' |
| HTML 表单 | express.urlencoded() | 'application/x-www-form-urlencoded' |
✅ 推荐调试方式（使用 curl）：
curl -X POST http://localhost:3000/api/stories/create \
-H "Content-Type: application/json" \
-d '{"title":"The Node Guide","author":"Alex"}'✅ 完整可运行示例（无依赖，开箱即用）
// app.js
const express = require('express');
const { infoBooks } = require('./data/books'); // 确保 books.js 导出 { infoBooks: { stories: [] } }
const app = express();
const PORT = 3000;
// ✅ 核心：全局启用解析中间件
app.use(express.json({ limit: '5mb' }));
app.use(express.urlencoded({ extended: true, limit: '5mb' }));
// 路由处理
app.post('/api/stories', (req, res) => {
const { title, author } = req.body;
if (!title || !author) {
return res.status(400).json({ error: 'Missing required fields: title and author' });
}
infoBooks.stories.push({ id: Date.now(), title, author });
res.status(201).json({ success: true, story: infoBooks.stories.at(-1) });
});
app.listen(PORT, () => {
console.log(`✅ Server running on http://localhost:${PORT}`);
});? 关键总结与避坑指南
- 中间件必须在 app.use() 全局注册，而非 router.use() —— 后者仅影响 Router 内部中间件链，不参与请求体解析。
- express.json() 和 express.urlencoded() 缺一不可，二者处理不同 Content-Type，现代 API 常需同时支持。
- 检查浏览器开发者工具 Network 标签页：确认请求的 Request Payload 是否有内容、Headers 中 Content-Type 是否正确、响应状态码是否为 400（常因中间件未启用导致）。
- 永远校验 req.body：即使中间件启用，空对象、null 或非预期类型仍可能发生，服务端需主动防御。
- 避免在 Router 中重复 use()：Router 的 use() 用于子路径中间件（如鉴权），而非替代全局解析器。
遵循以上步骤，你的 Express POST 接口将稳定接收数组、对象等任意 JSON 数据，告别 {} 和 400 错误。
