HTTP 请求解析:URL、Query、Params、Body

从请求中提取路径、查询参数、资源 ID 与 JSON 正文

🎯 引言

学完这篇文章,你能在接口中分别取得 URL 路径、Query、Params 和 JSON Body,知道每个值来自哪里。

🛠 准备请求参数示例

业务接口使用 Express 5。它负责匹配路由和解析请求,我们直接读取处理结果。Express 的初始化与语法已在 Express 课程 介绍,这里只关注请求参数。

新建 request-server.mjs,创建应用:

request-server.mjs
import express from 'express';

const app = express();

下面各段代码按顺序添加到同一个文件,最后再开始监听。


🧭 URL:读取请求路径

需要判断客户端访问哪个地址时,读取 req.path。下面只返回路径,方便观察:

request-server.mjs
app.get('/path', (req, res) => {
    res.json({ path: req.path });
});

访问 /path?tab=profile 得到 {"path":"/path"}。req.path 不包含问号后的查询参数;res.json 把结果作为 JSON 响应发回客户端。


🔎 Query:读取查询条件

Query 位于问号后,适合传页码或筛选条件。例如 /users?name=小明,通过 req.query.name 读取名字:

request-server.mjs
app.get('/users', (req, res) => {
    const name = req.query.name;
    if (name !== undefined && typeof name !== 'string') {
        return res.status(400).json({ error: 'name 只能提供一个字符串' });
    }
    res.json({ name: name ?? null });
});

传入 name=小明 返回 {"name":"小明"},不传返回 {"name":null}。本例只回显条件,没有查询数据库。

Query 需要校验后使用:重复提交同名参数可能得到数组,数字形式的查询值也不会自动成为数字。


🏷 Params:读取路径中的用户 ID

接口 /users/:id 中的 :id 代表一段可变化的路径,Express 将它放入 req.params.id:

request-server.mjs
app.get('/users/:id', (req, res) => {
    res.json({ id: req.params.id });
});

访问 /users/7 返回 {"id":"7"}。得到的是字符串;若数据库要求数字 ID,需要先校验再转换。路径参数通常指定操作对象,Query 通常补充查询条件。


📥 Body:读取 JSON 正文

在接收 JSON 的路由之前启用解析中间件。中间件是请求进入接口前后执行的处理函数;这里负责把 JSON 正文转换为对象:

request-server.mjs
app.use(express.json({ limit: '16kb' }));

limit 将正文大小限制为 16 KiB,超出时返回 413。请求应带 Content-Type: application/json,解析结果放在 req.body。不需要手工收集数据块,也不需要再调用 JSON.parse。

取出 name 并返回

下面的接口要求 JSON 正文中有字符串 name:

request-server.mjs
app.post('/users', (req, res) => {
    if (!req.is('application/json')) {
        return res.status(415).json({ error: '请发送 JSON' });
    }
    if (typeof req.body?.name !== 'string') {
        return res.status(400).json({ error: 'name 必须是字符串' });
    }
    res.json({ name: req.body.name });
});

提交 {"name":"小明"} 后,req.body.name 是 小明,响应为 {"name":"小明"}。这一步只验证参数读取,没有保存用户。JSON 语法错误会在解析中间件中返回 400,不会进入这个路由。


🧪 启动并检查结果

在文件末尾监听端口:

request-server.mjs
app.listen(3000, '127.0.0.1');

运行 node request-server.mjs。浏览器分别访问 /path?tab=profile、/users?name=小明、/users/7,会得到前面说明的 JSON。提交 Body 使用:

curl -i http://127.0.0.1:3000/users -H 'Content-Type: application/json' -d '{"name":"小明"}'

应得到状态 200 和 {"name":"小明"}。所有示例共用 3000 端口,运行前先停止其他练习服务。


❓ 知识问答

Q1:为什么原生 req 没有 body,Express 却有?

Express 的 JSON 中间件读取并解析了正文,将结果放到 req.body;它不是网络请求自动带来的对象。

Q2:GET 的 Query 也需要 express.json 吗?

不需要。Query 来自地址,JSON 中间件处理的是请求正文。

Q3:Params 中有 ID 就能直接查询数据库吗?

还需要检查 ID 的格式,并确认当前用户是否有权访问对应数据。


🧪 小练习

将请求中的 name 改为数字,确认得到 400;再用错误的正文类型发送,确认得到 415。

// 请在这里编写代码或记录结果