差别

这里会显示出您选择的修订版和当前版本之间的差别。

到此差别页面的链接

两侧同时换到之前的修订记录 前一修订版
后一修订版
前一修订版
请求头 [2026/10/16 10:29] – 补全请求头教程:结构、逐行拆解、HTTP/2 差异、代理头与排错清单 张叶安请求头 [2026/10/16 10:39] (当前版本) – 引用块内不解析行内标记,改为纯文本总结 张叶安
行 36: 行 36:
  
   * **作用**:一个 IP 上可能跑着很多站点(虚拟主机),服务端靠 ''Host'' 决定把这次请求交给哪个网站/哪个后端。   * **作用**:一个 IP 上可能跑着很多站点(虚拟主机),服务端靠 ''Host'' 决定把这次请求交给哪个网站/哪个后端。
-  * **写法**:只写主机名,可选端口;**不写** ''http://''、**不写**路径。+  * **写法**:只写主机名,可选端口;**不写**协议前缀(''http:'' 或 ''https:'')、**不写**路径。
  
 <code> <code>
行 97: 行 97:
 ===== 四、HTTP/2、HTTP/3 里的差异 ===== ===== 四、HTTP/2、HTTP/3 里的差异 =====
  
-抓包或看日志时,看到的是 ''\'':method'''' 这种带冒号的头,不要慌,这是同一套东西:HTTP/2 把请求行**拆成了伪头(pseudo-header)**。+抓包或看日志时,看到的是 %%:method%% 这种带冒号的头,不要慌,这是同一套东西:HTTP/2 把请求行**拆成了伪头(pseudo-header)**。
  
   * ''POST'' → '':method'';''/api/orders/create'' → '':path'';''http/https'' → '':scheme'';''Host'' → **'':authority''**。   * ''POST'' → '':method'';''/api/orders/create'' → '':path'';''http/https'' → '':scheme'';''Host'' → **'':authority''**。
行 115: 行 115:
 | ''Via'' | 经过的代理列表 | 排链路问题时有用 | | ''Via'' | 经过的代理列表 | 排链路问题时有用 |
  
-**通用原则**:所有 ''X-Forwarded-*'' 类头默认都不可信,只有「你信任的那层代理」写入的才作数;服务端要**覆盖**而不是**追加**不可信来源的值。+**通用原则**:所有 %%X-Forwarded-*%% 类头默认都不可信,只有「你信任的那层代理」写入的才作数;服务端要**覆盖**而不是**追加**不可信来源的值。
  
 ===== 六、联调排错清单 ===== ===== 六、联调排错清单 =====
行 124: 行 124:
 | 400 / 415 | ''Content-Type'' 与实际 body 是否匹配 | | 400 / 415 | ''Content-Type'' 与实际 body 是否匹配 |
 | 404 / 走错站点 | ''Host'' 是否被代理改写,路径是否带上了 base path | | 404 / 走错站点 | ''Host'' 是否被代理改写,路径是否带上了 base path |
-| 跨域失败 | ''Origin'',以及服务端的 ''Access-Control-Allow-*''(见 [[安全头]]) |+| 跨域失败 | ''Origin'',以及服务端的 %%Access-Control-Allow-*%%(见 [[安全头]]) |
 | 重复下单 | 是否漏了 ''X-Idempotency-Key'' 一类的幂等头 | | 重复下单 | 是否漏了 ''X-Idempotency-Key'' 一类的幂等头 |
  
行 138: 行 138:
 ===== 八、一句话总结 ===== ===== 八、一句话总结 =====
  
-> **请求头就是这次请求的说明书:请求行说"要做什么",''Host'' 说"找哪台服务器",''Authorization'' 说"我是谁",''X-App-Id'' 说"我从哪个应用来",''Content-Type'' 说"我带了什么格式的数据"。**+> 请求头就是这次请求的说明书:请求行说"要做什么",Host 说"找哪台服务器",Authorization 说"我是谁",X-App-Id 说"我从哪个应用来",Content-Type 说"我带了什么格式的数据"。
  
 参考: 参考:
行 151: 行 151:
  
 返回:[[首页]] 返回:[[首页]]
 +
 +```mdk height=560 color=#4f46e5
 +# 请求头(HTTP Request Headers)
 +
 +## 请求的四段结构
 +- 请求行:方法 + 路径 + 协议版本
 +- 请求头:键值对形式的元信息
 +- 空行:头与体的分界,必须有
 +- 请求体:真正发送的数据
 +
 +## 逐行拆解示例
 +- POST:提交/创建,会改状态
 +- 路径:只写资源,不写域名
 +- HTTP/1.1:协议版本
 +- 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/subtype + 参数
 +- 写错会 400 / 415
 +- 与 Accept 分工:我发的 / 我要的
 +- json、form、multipart、xml
 +
 +## 其他常见头
 +- Accept 能接受的响应格式
 +- User-Agent 客户端标识
 +- Content-Length 体长度
 +- Cookie 自动携带的会话凭证
 +- Origin / Referer 来源校验
 +- Accept-Encoding 压缩算法
 +
 +## HTTP/2 与 HTTP/3 差异
 +- 请求行拆成伪头
 +- :method :path :scheme :authority
 +- Host 对应 :authority
 +- 头名必须小写
 +- HPACK 压缩,重复头看起来"消失"
 +
 +## 代理链路加的头
 +- X-Forwarded-For 原始 IP
 +- X-Forwarded-Proto 原始协议
 +- X-Real-IP Nginx 约定
 +- X-Request-Id 链路追踪
 +- Via 代理列表
 +- 默认不可信,只信最外层代理
 +
 +## 排错清单
 +- 401:Authorization 与令牌有效期
 +- 403:X-App-Id 与令牌是否一致
 +- 400/415:Content-Type 与 body
 +- 404:Host 是否被改写
 +- 跨域:Origin 与 CORS 响应头
 +- 重复提交:幂等键
 +
 +## 通用规则
 +- 头名大小写不敏感
 +- 取值可能大小写敏感
 +- 不依赖头的顺序
 +- 不自造与标准冲突的头名
 +- 敏感头日志脱敏
 +- 头过长会被 431 拒绝
 +```
  

该主题尚不存在

您访问的页面并不存在。如果允许,您可以使用创建该页面按钮来创建它。

  • 请求头.1792117752.txt.gz
  • 最后更改: 2026/10/16 10:29
  • 由 张叶安