3. 实现请求体解析中间件处理 JSON 与表单

请求体解析的核心问题

HTTP 请求体是字节流，Node.js 的 http 模块不会自动把它变成对象。Express 的 express.json() 和 express.urlencoded() 中间件负责读取流、按 Content-Type 选择解析器、把结果挂到 req.body，并在解析失败时返回 400。理解这条数据链，才能正确配置和排错。

配置两个解析中间件

Express 4.16+ 内置了 express.json() 和 express.urlencoded()，无需额外安装 body-parser。两者都必须在路由之前注册，否则 req.body 为 undefined。

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

// 解析 JSON 请求体，限制 100kb
app.use(express.json({ limit: '100kb' }));

// 解析表单请求体，extended:false 使用 querystring，true 使用 qs
app.use(express.urlencoded({ extended: false, limit: '100kb' }));

app.post('/api/register', (req, res) => {
  const { username, age } = req.body;

  // 校验：字段存在且类型正确
  const errors = [];
  if (!username || typeof username !== 'string') {
    errors.push('username 必填且为字符串');
  }
  const ageNum = Number(age);
  if (!Number.isInteger(ageNum) || ageNum <= 0) {
    errors.push('age 必须为正整数');
  }

  if (errors.length > 0) {
    return res.status(400).json({ ok: false, errors });
  }
  res.json({ ok: true, data: { username, age: ageNum } });
});

app.listen(3000);

验证两种 Content-Type

用 curl 分别发送 JSON 和表单，观察 req.body 的类型差异：

# JSON 请求
curl -X POST http://localhost:3000/api/register \
  -H "Content-Type: application/json" \
  -d '{"username":"alice","age":25}'
# 返回 {"ok":true,"data":{"username":"alice","age":25}}

# 表单请求
curl -X POST http://localhost:3000/api/register \
  -H "Content-Type: application/x-www-form-urlencoded" \
  -d "username=bob&age=30"
# 返回 {"ok":true,"data":{"username":"bob","age":30}}

# 缺少 Content-Type
curl -X POST http://localhost:3000/api/register -d '{"username":"x"}'
# req.body 为空对象，返回 400 校验错误

校验结果判断表