计算机网络 / 系统课时

提交 URL 编码表单

提交 URL 编码表单

application/x-www-form-urlencoded 适合提交扁平的文本字段,例如登录名、搜索条件和简单设置。本篇直接观察请求体如何编码,再用 curl 发送真实 POST 请求并核对服务端解析结果,重点处理空格、&、重复字段和不适合使用该格式的情况。

学习目标

  • 读懂 application/x-www-form-urlencoded 请求体的键值结构与字符编码规则。
  • 生成并提交一个可验证的 URL 编码表单,确认服务器还原出的字段值。
  • 判断何时应改用 JSON 或 multipart/form-data。

请求体实际长什么样

这种表单把字段写成 name=value,多个字段用 & 连接,并通过请求头声明 Content-Type: application/x-www-form-urlencoded。HTML 表单的编码规则会把空格写成 +,把会影响结构的字符做百分号编码。

例如原始字段 email=alice@example.com 与 note=R&D review 可编码为 email=alice%40example.com&note=R%26D+review。其中 @ 变成 %40,& 变成 %26,空格变成 +;服务端按同一规则解码后,应恢复成原始文本。

空值与缺失字段也要区分:nickname= 表示字段存在但值为空,而完全不出现 nickname 表示没有提交该字段。做 PATCH、筛选或可选设置时,这个差异经常会影响业务语义。

生成表单并发送 POST 请求

下面用 Python 标准库生成表单编码,避免手工遗漏特殊字符,再让 curl 原样提交。示例需要本机存在 python3、curl 且能访问 https://httpbin.org。

bash
body=$(python3 -c 'from urllib.parse import urlencode; print(urlencode({"email":"alice@example.com","note":"R&D review"}))')
printf '%s\n' "$body"
curl -sS "https://httpbin.org/post" \
  -H "Content-Type: application/x-www-form-urlencoded" \
  --data "$body" \
| python3 -c 'import json,sys; print(json.dumps(json.load(sys.stdin)["form"], ensure_ascii=False, sort_keys=True))'

预期输出:

text
email=alice%40example.com&note=R%26D+review
{"email": "alice@example.com", "note": "R&D review"}

第一行是实际发送的请求体,第二行是服务器解码后的表单对象。若第二行仍出现 %26 或 +,说明服务端没有按该媒体类型解码;若 note 只剩 R,通常是请求体中的 & 没有被正确编码。

重复字段和字符边界

复选框或多选控件可能提交重复键,例如 tag=http&tag=network。服务端框架对重复键的 API 不统一:有的返回列表,有的默认只取第一个或最后一个,所以接口必须约定“允许重复键”还是“使用单个字段承载列表”。

字面量加号尤其容易出错。字段值 C++ 必须编码成 C%2B%2B;如果直接发送 C++,按表单规则解码时两个 + 可能被还原成空格。中文等非 ASCII 文本应由客户端库按 UTF-8 编码后再百分号转义,不要自行逐字符替换。

什么时候换成别的格式

URL 编码表单最适合一层键值字段。需要嵌套对象或明确数字、布尔值类型时,优先使用 application/json;需要上传文件时使用 multipart/form-data,不要把二进制文件塞进 URL 编码文本。

无论采用哪种格式,敏感表单都必须通过 HTTPS 传输。提交后至少检查三项:请求头的 Content-Type 是否正确、服务端解析出的字段名是否完整、包含 &、+、空格或中文的值是否能无损还原。满足这三项,编码和解码两端才真正对齐。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

提交 URL 编码表单

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通