HTTP 请求解析:URL、Query、Params、Body
🎯 引言
学完这篇文章,你能在接口中分别取得 URL 路径、Query、Params 和 JSON Body,知道每个值来自哪里。
🛠 准备请求参数示例
业务接口使用 Express 5。它负责匹配路由和解析请求,我们直接读取处理结果。Express 的初始化与语法已在 Express 课程 介绍,这里只关注请求参数。
新建 request-server.mjs,创建应用:
import express from 'express';
const app = express();
下面各段代码按顺序添加到同一个文件,最后再开始监听。
🧭 URL:读取请求路径
需要判断客户端访问哪个地址时,读取 req.path。下面只返回路径,方便观察:
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 读取名字:
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:
app.get('/users/:id', (req, res) => {
res.json({ id: req.params.id });
});
访问 /users/7 返回 {"id":"7"}。得到的是字符串;若数据库要求数字 ID,需要先校验再转换。路径参数通常指定操作对象,Query 通常补充查询条件。
📥 Body:读取 JSON 正文
在接收 JSON 的路由之前启用解析中间件。中间件是请求进入接口前后执行的处理函数;这里负责把 JSON 正文转换为对象:
app.use(express.json({ limit: '16kb' }));
limit 将正文大小限制为 16 KiB,超出时返回 413。请求应带 Content-Type: application/json,解析结果放在 req.body。不需要手工收集数据块,也不需要再调用 JSON.parse。
取出 name 并返回
下面的接口要求 JSON 正文中有字符串 name:
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,不会进入这个路由。
🧪 启动并检查结果
在文件末尾监听端口:
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。
// 请在这里编写代码或记录结果
