一个 HTTP 请求(Request)由四部分组成:请求行、请求头、一个空行、请求体。请求头是夹在请求行和请求体之间的若干行 键: 值,用来描述「这次请求的元信息」——找哪台服务器、我是谁、我从哪个应用来、我带的body是什么格式。
下面用一个「创建订单」类接口做示例。出于安全,域名、令牌、应用标识一律用占位符代替(<访问令牌>、<子应用标识> 这类值属于敏感信息,不该出现在任何文档里):
POST /api/orders/create HTTP/1.1 ← 请求行:方法 + 路径 + 协议版本
Host: api.example.com ← 请求头开始
Authorization: Bearer <访问令牌>
X-App-Id: <子应用标识>
Content-Type: application/json ← 描述请求体的格式
{ "skuId": 1001, "qty": 2 } ← 空行之后是请求体
| 组成 | 作用 | 备注 |
|---|---|---|
| 请求行 | 方法 + 路径 + 协议版本 | 不是请求头,第一行 |
| 请求头 | 键: 值,逐行排列 | 大小写不敏感,顺序不保证 |
| 空行 | 分隔「头」与「体」 | 必须有,少了会被当成坏请求 |
| 请求体 | 真正要发送的数据 | GET 一般没有;POST / PUT 常有 |
示例的第一行不是头,而是请求行,三部分用空格隔开:
POST —— 方法。语义是「提交/创建」,通常会改变服务端状态,因此不该被缓存、不该被随意重放。/api/orders/create —— 路径(含查询串)。只写资源路径,不写协议和域名;域名由下面 Host 头负责。HTTP/1.1 —— 协议版本。它决定了这条报文长什么样,也决定了 Host 是不是必填。(HTTP/2 里这一行不再明文出现,见第四节。)HTTP/1.1 起唯一被强制要求的请求头。
Host 决定把这次请求交给哪个网站/哪个后端。http: 或 https:)、不写路径。Host: api.example.com Host: api.example.com:8443 // 非默认端口才写端口
Host 路由(见 回源)。Host 有没有被上游代理改写。
这是认证凭证的标准位置,语法固定为 <方案名> <凭证>。
Bearer 是方案名,后面是一枚不透明令牌(JWT、OAuth2 access token 等)——“不透明”的意思是服务端不靠语法解析它,而是直接拿去验签/查库,且谁拿到都能用,等同于密码。Basic 只是 base64 编码而非加密,明文传输等于把密码广播出去。Referer、服务器日志,等于到处留副本),只能走请求头。X-Api-Key)分开承载。这是自定义头(非标准头),用来告诉服务端「这次请求来自哪个子应用/租户」。
| 头 | 回答的问题 | 谁提供 |
|---|---|---|
Authorization | 你是哪个用户,凭证有效吗 | 登录后由服务端签发 |
X-App-Id | 你从哪个应用/入口进来 | 由调用方固定带上 |
X- 前缀是老约定,表示「厂商自定义扩展」。现在规范上已不推荐新头再用 X-,但存量系统里到处都是。Authorization 是分工关系:一个回答“哪个用户”,一个回答“哪个应用”。两者组合,服务端才能判断「这个用户在这个子应用下能做什么」。X-App-Id,所以服务端不能只凭它做权限判定,必须与令牌里的应用标识(app / aud / iss 等字段)交叉校验,否则就是越权漏洞。X-Request-Id(链路追踪)、X-Forwarded-For(客户端 IP)、X-Trace-Id、X-Idempotency-Key(幂等)。x-app-id 等价),但约定俗成写成 X-App-Id。它描述的是请求体的媒体类型——“我发给你的数据是什么格式”,与请求头本身无关。
type/subtype,可带参数(charset、boundary 等)。Accept 混:Accept 是“我希望响应是什么格式”,Content-Type 是“我发给你的是什么格式”。| Content-Type | 典型场景 |
|---|---|
application/json | 前后端 JSON 接口,最常见 |
application/x-www-form-urlencoded | 传统表单提交 |
multipart/form-data | 含文件上传的表单 |
text/plain | 纯文本 |
application/xml | 老式 XML 接口 |
抓包或看日志时,看到的是 :method 这种带冒号的头,不要慌,这是同一套东西:HTTP/2 把请求行拆成了伪头(pseudo-header)。
POST → :method;/api/orders/create → :path;http/https → :scheme;Host → :authority。content-type);HTTP/1.1 则大小写不敏感。经过 Nginx、网关、CDN 之后,请求头往往已经不是你发出去的那一份了:
| 头 | 含义 | 注意 |
|---|---|---|
X-Forwarded-For | 原始客户端 IP(逐级追加) | 可伪造,只信最外层代理重置的值 |
X-Forwarded-Proto | 原始协议(http/https) | 用于生成回调地址、强制跳转 |
X-Real-IP | 单个客户端 IP(Nginx 约定) | 与上面含义重叠,取值口径要统一 |
X-Request-Id | 全链路追踪 ID | 建议入口生成、透传到底 |
Via | 经过的代理列表 | 排链路问题时有用 |
通用原则:所有 X-Forwarded-* 类头默认都不可信,只有「你信任的那层代理」写入的才作数;服务端要覆盖而不是追加不可信来源的值。
| 现象 | 先看哪个头 |
|---|---|
| 401 未认证 | Authorization 是否带了、scheme 拼写对不对、令牌是否过期 |
| 403 无权限 | 凭证有效但权限不足;核对 X-App-Id 与令牌里的应用标识是否一致 |
| 400 / 415 | Content-Type 与实际 body 是否匹配 |
| 404 / 走错站点 | Host 是否被代理改写,路径是否带上了 base path |
| 跨域失败 | Origin,以及服务端的 Access-Control-Allow-*(见 安全头) |
| 重复下单 | 是否漏了 X-Idempotency-Key 一类的幂等头 |
Bearer 与 bearer 等价,但令牌本身一个字符都不能错)。Set-Cookie)例外。X- 前缀或自有的命名空间。Authorization、Cookie、X-Api-Key 默认不得全量落日志。请求头就是这次请求的说明书:请求行说"要做什么",Host 说"找哪台服务器",Authorization 说"我是谁",X-App-Id 说"我从哪个应用来",Content-Type 说"我带了什么格式的数据"。
参考:
相关:Authorization · Bearer · JWT · 安全头 · GET_PUT_POST · 回源 · Cookie
返回:首页
# 请求头(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 拒绝