解决 Express 中 POST 请求无法接收数组或 JSON 数据的问题

✅ 推荐做法：在应用级全局注册解析中间件（更可靠、符合最佳实践）：

const express = require('express');
const app = express();

// ✅ 关键：全局启用 JSON 和 URL-encoded 解析
app.use(express.json({ limit: '10mb' })); // 解析 JSON 请求体
app.use(express.urlencoded({ extended: true, limit: '10mb' })); // 解析 form-data / x-www-form-urlencoded

// ✅ 此时再引入并使用 router
const routerStories = require('./routes/stories'); // 假设路由已重构
app.use('/api/stories', routerStories);

⚠️ 注意：express.json() 和 express.urlencoded() 必须放在所有路由定义之前，否则后续路由将无法访问解析后的 req.body。

✅ 修正模块导入与数据操作逻辑

你原代码中的解构写法：

Voiceflow

Voiceflow 是一个AI驱动的聊天机器人构建平台，可以帮您设计、开发和发布聊天机器人。

下载

const { stories } = require('../data/books.js').infoBooks;

存在两个风险：

• 若 books.js 导出为 module.exports = { infoBooks: { stories: [...] } }，则 .infoBooks 访问是合法的；
• 但若 books.js 使用 ES 模块导出（如 export const infoBooks = {...}），此写法会报错（Node.js 中需用 import）；
• 更严重的是：stories 是一个原始数组引用，直接 push() 会污染模块缓存，导致多请求间状态混乱。

✅ 推荐重构为安全、可维护的模式：

// ./data/books.js
export const infoBooks = {
  stories: []
};

// ./routes/stories.js
import { infoBooks } from '../data/books.js';
import express from 'express';
const router = express.Router();

router.post('/create', (req, res) => {
  const { title, author, content } = req.body;

  // ✅ 强制校验必要字段（避免空对象入库）
  if (!title || !author) {
    return res.status(400).json({
      error: 'Missing required fields: title and author'
    });
  }

  const newBook = { id: Date.now(), title, author, content };
  infoBooks.stories.push(newBook);

  // ✅ 使用 res.json() 自动设置 Content-Type 和序列化
  res.status(201).json({
    message: 'Book created successfully',
    data: newBook,
    total: infoBooks.stories.length
  });
});

export default router;

✅ 客户端请求必须匹配服务端配置

即使服务端完全正确，客户端发送方式错误仍会导致失败：

✅ 调试技巧：快速定位问题根源

在路由处理器开头添加日志，确认请求是否抵达及原始数据状态：

router.post('/create', (req, res) => {
  console.log('Raw headers:', req.headers);
  console.log('Raw body:', req.body); // 若为 {}，说明中间件未生效
  console.log('Raw rawBody:', req.rawBody); // 需配合 body-parser 的 verify 选项获取原始流

  // ...后续逻辑
});

总结：四步自查清单

1. 中间件是否启用？ → 检查 app.use(express.json()) 和 app.use(express.urlencoded()) 是否存在且位于 app.use(router) 之前；
2. 请求头是否匹配？ → Content-Type: application/json 对应 JSON 数据，application/x-www-form-urlencoded 对应表单；
3. 路由路径是否一致？ → 客户端请求路径（如 /api/stories/create）必须与 router.post('/create', ...) 中的路径拼接后完全匹配；
4. 数据结构是否有效？ → 使用 console.log(req.body) 验证，避免空对象或格式错误（如字符串而非 JSON 对象）。

遵循以上规范，你的 Express POST 接口即可稳定接收数组、对象等复杂数据结构，为构建健壮的 RESTful API 打下坚实基础。