差别
这里会显示出您选择的修订版和当前版本之间的差别。
| 后一修订版 | 前一修订版 | ||
| 请求头 [2026/10/16 10:26] – 创建 张叶安 | 请求头 [2026/10/16 10:39] (当前版本) – 引用块内不解析行内标记,改为纯文本总结 张叶安 | ||
|---|---|---|---|
| 行 1: | 行 1: | ||
| - | 1 | + | ====== 请求头(HTTP Request Headers) ====== |
| + | |||
| + | 一个 HTTP 请求(Request)由四部分组成:**请求行**、**请求头**、**一个空行**、**请求体**。请求头是夹在请求行和请求体之间的若干行 '' | ||
| + | |||
| + | 下面用一个「创建订单」类接口做示例。出于安全,域名、令牌、应用标识**一律用占位符**代替(''< | ||
| + | |||
| + | <code http> | ||
| + | POST / | ||
| + | Host: api.example.com | ||
| + | Authorization: | ||
| + | X-App-Id: < | ||
| + | Content-Type: | ||
| + | |||
| + | { " | ||
| + | </ | ||
| + | |||
| + | ^ 组成 ^ 作用 ^ 备注 ^ | ||
| + | | 请求行 | 方法 + 路径 + 协议版本 | 不是请求头,第一行 | | ||
| + | | 请求头 | '' | ||
| + | | 空行 | 分隔「头」与「体」 | **必须有**,少了会被当成坏请求 | | ||
| + | | 请求体 | 真正要发送的数据 | '' | ||
| + | |||
| + | ===== 一、先拆请求行 ===== | ||
| + | |||
| + | 示例的第一行**不是头**,而是请求行,三部分用空格隔开: | ||
| + | |||
| + | * '' | ||
| + | * ''/ | ||
| + | * '' | ||
| + | |||
| + | ===== 二、逐个头拆解 ===== | ||
| + | |||
| + | ==== Host: < | ||
| + | |||
| + | **HTTP/1.1 起唯一被强制要求的请求头。** | ||
| + | |||
| + | * **作用**:一个 IP 上可能跑着很多站点(虚拟主机),服务端靠 '' | ||
| + | * **写法**:只写主机名,可选端口;**不写**协议前缀('' | ||
| + | |||
| + | < | ||
| + | Host: api.example.com | ||
| + | Host: api.example.com: | ||
| + | </ | ||
| + | |||
| + | * 顺带记住:浏览器的同源判定、Cookie 的作用域都和它相关;反向代理、CDN 回源也常常按 '' | ||
| + | * 排错价值:明明接口是对的却 404,第一件事就是看 '' | ||
| + | |||
| + | ==== Authorization: | ||
| + | |||
| + | 这是**认证凭证的标准位置**,语法固定为 ''< | ||
| + | |||
| + | * '' | ||
| + | * 必须走 **HTTPS**;'' | ||
| + | * **绝不要放进 URL 的 query**(会进浏览器历史、'' | ||
| + | * 一个请求只用一种方案;确需多种凭证时用自定义头(如 '' | ||
| + | * 详解见 [[代码术语: | ||
| + | |||
| + | ==== X-App-Id: < | ||
| + | |||
| + | 这是**自定义头**(非标准头),用来告诉服务端「这次请求来自哪个子应用/租户」。 | ||
| + | |||
| + | ^ 头 ^ 回答的问题 ^ 谁提供 ^ | ||
| + | | '' | ||
| + | | '' | ||
| + | |||
| + | * '' | ||
| + | * 与 '' | ||
| + | * **重要**:客户端可以随意伪造 '' | ||
| + | * 常见的同类头:'' | ||
| + | * 头名**大小写不敏感**('' | ||
| + | |||
| + | ==== Content-Type: | ||
| + | |||
| + | 它描述的是**请求体**的媒体类型——" | ||
| + | |||
| + | * 值的形式是 '' | ||
| + | * 服务端常据此选择解析器:值写错、或与实际 body 不一致,就会得到 **400**(解析失败)或 **415**(不支持的媒体类型)。 | ||
| + | * 别和 '' | ||
| + | |||
| + | ^ Content-Type ^ 典型场景 ^ | ||
| + | | '' | ||
| + | | '' | ||
| + | | '' | ||
| + | | '' | ||
| + | | '' | ||
| + | |||
| + | ===== 三、还有哪些常见头 ===== | ||
| + | |||
| + | ^ 头 ^ 作用 ^ | ||
| + | | '' | ||
| + | | '' | ||
| + | | '' | ||
| + | | '' | ||
| + | | '' | ||
| + | | '' | ||
| + | |||
| + | ===== 四、HTTP/ | ||
| + | |||
| + | 抓包或看日志时,看到的是 %%:method%% 这种带冒号的头,不要慌,这是同一套东西:HTTP/ | ||
| + | |||
| + | * '' | ||
| + | * HTTP/2 中**头名必须小写**('' | ||
| + | * 头会经过 HPACK 压缩,因此同一连接上的重复头在流量里看起来" | ||
| + | * 伪头必须出现在所有普通头**之前**,且不能自己手写发送。 | ||
| + | |||
| + | ===== 五、代理链路中被" | ||
| + | |||
| + | 经过 Nginx、网关、CDN 之后,请求头往往已经不是你发出去的那一份了: | ||
| + | |||
| + | ^ 头 ^ 含义 ^ 注意 ^ | ||
| + | | '' | ||
| + | | '' | ||
| + | | '' | ||
| + | | '' | ||
| + | | '' | ||
| + | |||
| + | **通用原则**:所有 %%X-Forwarded-*%% 类头默认都不可信,只有「你信任的那层代理」写入的才作数;服务端要**覆盖**而不是**追加**不可信来源的值。 | ||
| + | |||
| + | ===== 六、联调排错清单 ===== | ||
| + | |||
| + | ^ 现象 ^ 先看哪个头 ^ | ||
| + | | 401 未认证 | '' | ||
| + | | 403 无权限 | 凭证有效但权限不足;核对 '' | ||
| + | | 400 / 415 | '' | ||
| + | | 404 / 走错站点 | '' | ||
| + | | 跨域失败 | '' | ||
| + | | 重复下单 | 是否漏了 '' | ||
| + | |||
| + | ===== 七、写请求头的通用规则 ===== | ||
| + | |||
| + | * **头名大小写不敏感,取值可能大小写敏感**(如 '' | ||
| + | * **不要依赖头的顺序**;同名头重复出现时,多数头应等价于逗号合并,少数头(如 '' | ||
| + | * **不要自造会与标准冲突的头名**;自定义头优先用 '' | ||
| + | * **敏感头必须脱敏**:'' | ||
| + | * **头过长会被拒**:服务端可能回 **431 Request Header Fields Too Large**。 | ||
| + | * **凭证类头只在 HTTPS 上传**,这是所有规则里最不能省的一条。 | ||
| + | |||
| + | ===== 八、一句话总结 ===== | ||
| + | |||
| + | > 请求头就是这次请求的说明书:请求行说" | ||
| + | |||
| + | 参考: | ||
| + | |||
| + | * RFC 9110 —— [[https:// | ||
| + | * RFC 9113 —— [[https:// | ||
| + | * MDN —— [[https:// | ||
| + | |||
| + | 相关:[[代码术语: | ||
| + | |||
| + | ---- | ||
| + | |||
| + | 返回:[[首页]] | ||
| + | |||
| + | ```mdk height=560 color=# | ||
| + | # 请求头(HTTP Request Headers) | ||
| + | |||
| + | ## 请求的四段结构 | ||
| + | - 请求行:方法 + 路径 + 协议版本 | ||
| + | - 请求头:键值对形式的元信息 | ||
| + | - 空行:头与体的分界,必须有 | ||
| + | - 请求体:真正发送的数据 | ||
| + | |||
| + | ## 逐行拆解示例 | ||
| + | - POST:提交/ | ||
| + | - 路径:只写资源,不写域名 | ||
| + | - HTTP/ | ||
| + | - Host:找哪台服务器 | ||
| + | - Authorization:我是谁 | ||
| + | - X-App-Id:我从哪个应用来 | ||
| + | - Content-Type:我带的数据什么格式 | ||
| + | |||
| + | ## Host 必填头 | ||
| + | - HTTP/1.1 起唯一强制要求 | ||
| + | - 虚拟主机路由的依据 | ||
| + | - 只写主机名 + 可选端口 | ||
| + | - 不写协议、不写路径 | ||
| + | - 代理 / CDN 回源按它分发 | ||
| + | - 被改写会导致 404 | ||
| + | |||
| + | ## Authorization | ||
| + | - 语法:scheme + 凭证 | ||
| + | - Bearer = 不透明令牌 | ||
| + | - 谁拿到都能用,等同密码 | ||
| + | - 必须走 HTTPS | ||
| + | - 绝不放 URL query | ||
| + | - 一个请求只用一种方案 | ||
| + | - 401 先查这里 | ||
| + | |||
| + | ## 自定义头 X-App-Id | ||
| + | - X- 前缀=厂商扩展 | ||
| + | - 回答" | ||
| + | - 与 Authorization 分工 | ||
| + | - 客户端可伪造,不能单独做鉴权 | ||
| + | - 须与 token 的 app/aud 交叉校验 | ||
| + | - 同类:X-Request-Id、X-Idempotency-Key | ||
| + | |||
| + | ## Content-Type | ||
| + | - 描述请求体,不描述头 | ||
| + | - 形式:type/ | ||
| + | - 写错会 400 / 415 | ||
| + | - 与 Accept 分工:我发的 / 我要的 | ||
| + | - json、form、multipart、xml | ||
| + | |||
| + | ## 其他常见头 | ||
| + | - Accept 能接受的响应格式 | ||
| + | - User-Agent 客户端标识 | ||
| + | - Content-Length 体长度 | ||
| + | - Cookie 自动携带的会话凭证 | ||
| + | - Origin / Referer 来源校验 | ||
| + | - Accept-Encoding 压缩算法 | ||
| + | |||
| + | ## HTTP/2 与 HTTP/3 差异 | ||
| + | - 请求行拆成伪头 | ||
| + | - :method :path :scheme : | ||
| + | - Host 对应 : | ||
| + | - 头名必须小写 | ||
| + | - HPACK 压缩,重复头看起来" | ||
| + | |||
| + | ## 代理链路加的头 | ||
| + | - X-Forwarded-For 原始 IP | ||
| + | - X-Forwarded-Proto 原始协议 | ||
| + | - X-Real-IP Nginx 约定 | ||
| + | - X-Request-Id 链路追踪 | ||
| + | - Via 代理列表 | ||
| + | - 默认不可信,只信最外层代理 | ||
| + | |||
| + | ## 排错清单 | ||
| + | - 401:Authorization 与令牌有效期 | ||
| + | - 403:X-App-Id 与令牌是否一致 | ||
| + | - 400/ | ||
| + | - 404:Host 是否被改写 | ||
| + | - 跨域:Origin 与 CORS 响应头 | ||
| + | - 重复提交:幂等键 | ||
| + | |||
| + | ## 通用规则 | ||
| + | - 头名大小写不敏感 | ||
| + | - 取值可能大小写敏感 | ||
| + | - 不依赖头的顺序 | ||
| + | - 不自造与标准冲突的头名 | ||
| + | - 敏感头日志脱敏 | ||
| + | - 头过长会被 431 拒绝 | ||
| + | ``` | ||