Node.js跨文件处理请求时req.body返回undefined问题求助

常见原因及解决办法 #

1. 未配置请求体解析中间件 #

Node.js框架（如Express）默认不会自动解析JSON或表单格式的请求体，必须手动添加对应中间件：

• 解析JSON格式请求体：

  const express = require('express');
  const app = express();
  
  // 必须在路由之前添加
  app.use(express.json());
  

• 解析URL编码的表单数据：

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

2. 请求头Content-Type与数据格式不匹配 #

客户端发送数据时，需确保Content-Type头和实际数据格式一致：

• 发送JSON数据时，fetch配置需包含：

  fetch('/api/login', {
    method: 'POST',
    headers: {
      'Content-Type': 'application/json', // 必须设置
    },
    body: JSON.stringify({ email: 'test@example.com', password: '123456' })
  });
  

• 如果发送的是FormData，不要手动设置Content-Type，浏览器会自动处理；后端需使用multer中间件解析。

3. 请求方法错误 #

GET请求没有请求体，若客户端用GET方法发送数据，后端必然拿不到req.body。

• 解决：客户端改用POST、PUT等支持请求体的HTTP方法。

4. 中间件顺序错误 #

解析请求体的中间件必须放在路由定义之前，否则路由处理时请求体还未被解析：
错误示例：

// 错误：路由先定义，中间件后添加
app.post('/api/login', (req, res) => { /* ... */ });
app.use(express.json());

正确示例：

// 正确：中间件先添加，再定义路由
app.use(express.json());
app.post('/api/login', (req, res) => { /* ... */ });

5. 客户端数据序列化错误 #

如果客户端没有正确序列化数据，比如直接传递对象而不使用JSON.stringify()，后端无法解析：
错误示例：

// 错误：body直接传对象
body: { email: 'test@example.com' }

正确示例：

// 正确：用JSON.stringify序列化
body: JSON.stringify({ email: 'test@example.com' })

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