计算机网络 / 系统课时
传递查询参数
传递查询参数
查询参数适合把筛选、排序、分页这类短小条件附在 URL 上。本篇用一个可运行的 GET 请求演示参数边界、百分号编码和重复参数,最后给出服务端检查方法,避免因为 &、+、中文等字符被误拆而得到错误结果。
学习目标
- 看懂
?、&、=在查询字符串中的职责,并能组织常见筛选与分页参数。 - 使用百分号编码安全传递特殊字符,不手工拼接可能破坏参数结构的值。
- 用
curl验证服务端实际收到的参数和值。
查询参数在 URL 中的位置
HTTP 请求目标中,路径后第一个 ? 开始查询字符串,多个键值通常用 & 分隔,键和值之间用 =。例如 /products?category=book&page=2&sort=price 表示三个独立参数;参数顺序通常不应承载业务含义。
同一个键可以重复出现,例如 /articles?tag=http&tag=network。服务端可能把它解析成列表,也可能只保留一个值,因此接口文档必须明确约定。分页可采用 page=3&pageSize=20,并在服务端限制 pageSize,例如允许 1~100,超过时返回参数错误而不是无限放大查询。
特殊字符必须编码
参数值里的分隔符不能直接当普通字符使用。字母、数字以及 -._~ 通常可原样保留;&、=、%、+ 等字符应编码,非 ASCII 文本先按 UTF-8 转成字节,再做百分号编码。
| 原始值 | 查询字符串中的安全写法 | 原因 |
|---|---|---|
a&b |
a%26b |
防止 & 被当成下一个参数的分隔符 |
x=y |
x%3Dy |
防止 = 被误当成键值分隔符 |
C++ |
C%2B%2B |
很多查询解析器会把 + 当空格 |
100% |
100%25 |
% 本身是编码前缀 |
不要把用户输入直接拼成 ?q= 后面的文本。若值是 a&b,手工得到 ?q=a&b 时,服务器可能把它理解为参数 q=a 和另一个参数 b,原始值已经丢失。
用 curl 正确生成查询字符串
curl 的 -G 会把数据放到 URL 查询部分,--data-urlencode 会对每个值进行编码。下面请求故意把 & 放进 q 的值中,用于检查它是否仍然作为一个完整值到达服务端。
curl -sS -G "https://httpbin.org/get" \
--data-urlencode "q=a&b" \
--data-urlencode "page=2"预期输出(只列与本课相关的字段;服务还会返回其他请求信息):
{
"args": {
"page": "2",
"q": "a&b"
},
"url": "https://httpbin.org/get?q=a%26b&page=2"
}这里能同时验证两件事:传输中的 & 被编码为 %26,服务端解码后仍得到完整字符串 a&b;page 则保持普通数字文本 "2"。实际项目中应让 HTTP 客户端库负责编码,不要先手工把值改成 %26 再交给自动编码 API,否则可能出现二次编码 %2526。
设计筛选、排序与分页参数
查询参数应保持简单、可预测。一个列表接口可以采用 /orders?status=paid&sort=-created_at&page=3&pageSize=20:status 负责筛选,sort=-created_at 约定按创建时间降序,分页每页 20 条。后端应对未知排序字段做白名单校验,例如只允许 created_at、total、id。
GET 查询参数还会出现在浏览器历史、代理日志、访问日志和监控链路中,因此不要放密码、令牌或身份证号等敏感值。调试时最终检查的是“服务端解码后的键和值”,而不是只看地址栏是否像预期;只要 q=a&b 能被还原为一个值,而不是两个参数,编码链路就是正确的。