目录

请求头(HTTP Request Headers)

一个 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 常有

一、先拆请求行

示例的第一行不是头,而是请求行,三部分用空格隔开:

二、逐个头拆解

Host: <主站域名>

HTTP/1.1 起唯一被强制要求的请求头。

Host: api.example.com
Host: api.example.com:8443      // 非默认端口才写端口

Authorization: Bearer <访问令牌>

这是认证凭证的标准位置,语法固定为 <方案名> <凭证>。

X-App-Id: <子应用标识>

这是自定义头(非标准头),用来告诉服务端「这次请求来自哪个子应用/租户」。

头 回答的问题 谁提供
Authorization 你是哪个用户,凭证有效吗 登录后由服务端签发
X-App-Id 你从哪个应用/入口进来 由调用方固定带上

Content-Type: application/json

它描述的是请求体的媒体类型——“我发给你的数据是什么格式”,与请求头本身无关。

Content-Type 典型场景
application/json 前后端 JSON 接口,最常见
application/x-www-form-urlencoded 传统表单提交
multipart/form-data 含文件上传的表单
text/plain 纯文本
application/xml 老式 XML 接口

三、还有哪些常见头

头 作用
Accept 能接受的响应格式,如 application/json
User-Agent 客户端标识(浏览器、SDK 版本)
Content-Length 请求体字节数;与 Transfer-Encoding 互斥
Cookie 浏览器自动携带的会话凭证(见 Cookie)
Origin / Referer 请求来源,跨域与 CSRF 校验看它(见 CSRF)
Accept-Encoding 允许的压缩算法,如 gzip, br

四、HTTP/2、HTTP/3 里的差异

抓包或看日志时,看到的是 :method 这种带冒号的头,不要慌,这是同一套东西:HTTP/2 把请求行拆成了伪头(pseudo-header)。

五、代理链路中被"加"上的头

经过 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 一类的幂等头

七、写请求头的通用规则

八、一句话总结

请求头就是这次请求的说明书:请求行说"要做什么",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 拒绝