1 / 4概念
HTTP
这一页判定的是“一次 HTTP 交互的语义由谁保证”:方法与状态码表达意图,表达框架决定并发与阻塞位置,中间件决定哪些头能活到下一跳。读完应能判断该用哪个版本、失败能否安全重试、以及代理为什么吃掉了某个头。
1 概念
1.1 一句话定义
HTTP 是运行在可靠传输之上、以请求/响应为单位、用方法表达意图、用三位状态码表达结果的应用协议;语义定义在 RFC 9110,表达框架分别由 HTTP/1.1、HTTP/2 与 HTTP/3 定义。
1.2 它解决什么问题
- 统一意图表达:方法说明“想做什么”,状态码说明“结果如何”,中间件不必理解业务就能路由、缓存和限流。
- 无状态可扩展:每个请求自带认证、内容协商与追踪上下文,服务端可以水平扩容。
- 中间件友好:代理、网关、CDN 与负载均衡都按同一套语义工作,这是 HTTP 长期占据入口的原因。
- 版本演进而契约不变:从 1.1 到 h2 到 h3,同一份 API 可以只换表达与传输,不改资源模型。
1.3 不属于本页的内容
| 主题 | 去哪 |
|---|---|
| TLS 握手、证书与密钥交换 | TLS / Certificate Chain and Validation |
| Cache-Control、ETag 与失效策略 | HTTP Caching |
| QUIC 的 stream、0-RTT 与连接迁移 | QUIC |
| protobuf 契约与 gRPC 流式模式 | RPC and gRPC |
1.4 关键术语
| 术语 | 含义 | 容易混淆的点 |
|---|---|---|
| 方法 | 请求意图的动词,决定语义与幂等性 | 不是路由,也不代表权限 |
| 幂等 | 重复执行与执行一次的效果相同 | 幂等不表示每次响应相同 |
| framing | 把报文切成可解析单位的方式 | 不是序列化格式 |
| stream | h2/h3 中一条独立的请求/响应通道 | 不是 TCP 连接 |
| ALPN | TLS 握手时协商应用协议的扩展 | 不是 HTTP 头,也不直接协商 h3 |
| trailer | 位于消息体之后的头字段 | 不是响应头,gRPC 状态走这里 |
2 机制
2.1 心智模型
把一次交互拆成三个平面,外加一层中间件视角,排障时先定位坏在哪一层:语义错返回 4xx/5xx,表达错表现为 stream 被重置,传输错表现为超时或握手失败。
| 平面 | 内容 | 变更频率 | 典型故障表现 |
|---|---|---|---|
| 语义 | 方法、状态码、头字段、条件请求 | 极少变 | 405、415、422 等语义错误 |
| 表达 | 文本报文、h2 帧、h3 帧 | 每代重写 | 解析失败、RST_STREAM |
| 传输 | TCP、TLS、QUIC | 与表达解耦 | 超时、RST、握手失败 |
2.2 机制拆解
- HTTP/1.1:持久连接把多条请求串行复用到同一 TCP 连接;pipelining 因队头阻塞与中间件支持差已基本不用;浏览器每源约开 6 条连接绕过串行。
- HTTP/2:连接先发 preface 与 SETTINGS;每个请求是一条 stream,由 HEADERS、DATA、RST_STREAM 等帧组成;HPACK 压缩头;WINDOW_UPDATE 做流控;GOAWAY 优雅收尾。
- HTTP/3:帧跑在 QUIC 的独立 stream 上,丢包只阻塞所在 stream;QPACK 处理头压缩与乱序;握手 1-RTT,复用可 0-RTT;连接 ID 让网络切换不断连。
- 版本协商:客户端在 TLS ClientHello 的 ALPN 中列出协议,服务端选定;h3 通常先由 h2 响应中的 Alt-Svc 或 HTTPS 记录发现,再尝试 UDP。
- 代理形态:origin-form 直连源站,absolute-form 用于正向代理,CONNECT 建隧道;hop-by-hop 头由每一跳消费,Via 与 Forwarded 记录路径。
- 幂等与重试:GET、HEAD、PUT、DELETE、OPTIONS、TRACE 幂等,POST 与 PATCH 不幂等;网关只应对幂等方法自动重试,写接口需要幂等键。
2.3 完整枚举
HTTP 核心方法全集如下,安全性与幂等性直接决定能否缓存、能否自动重试。
| 方法 | 安全 | 幂等 | 请求体 | 典型用途 | 注意点 |
|---|---|---|---|---|---|
| GET | 是 | 是 | 不应有 | 读取资源 | 缓存与日志的主体 |
| HEAD | 是 | 是 | 不应有 | 只取头 | 头必须与同 URL 的 GET 一致 |
| POST | 否 | 否 | 有 | 创建、提交、动作 | 重试需要幂等键 |
| PUT | 否 | 是 | 有 | 整体替换 | URI 由客户端决定 |
| DELETE | 否 | 是 | 可无 | 删除资源 | 重复删除返回 404 仍算幂等 |
| CONNECT | 否 | 否 | 无 | 建立隧道 | 仅用于代理场景 |
| OPTIONS | 是 | 是 | 无 | 能力探测、CORS 预检 | 常被网关默认拦截 |
| TRACE | 是 | 是 | 无 | 回显请求 | 生产环境通常禁用 |
| PATCH | 否 | 否 | 有 | 局部更新 | 需 If-Match 防覆盖 |
状态码按类别穷举,类别决定客户端与中间件的默认处理策略。
| 类别 | 含义 | 常见成员 | 处理取向 |
|---|---|---|---|
| 1xx | 信息性 | 100 Continue、101 Switching Protocols、103 Early Hints | 协议内部使用,业务不应依赖 |
| 2xx | 成功 | 200、201、202、204、206 | 正常路径 |
| 3xx | 重定向 | 301、302、303、304、307、308 | 注意方法是否被改写、可否缓存 |
| 4xx | 客户端错误 | 400、401、403、404、405、409、412、415、422、429 | 不要自动重试,429 按 Retry-After |
| 5xx | 服务端错误 | 500、501、502、503、504 | 结合幂等性判断能否重试 |
2.4 关键数字与量级
| 指标 | 量级 | 说明 |
|---|---|---|
| 请求头总大小 | 8–16 KB | 各代理默认不同,超限返回 431 或 400 |
| h2 默认最大帧 | 16 KB | SETTINGS_MAX_FRAME_SIZE 可调 |
| h2 初始流窗口 | 65,535 字节 | 需要 WINDOW_UPDATE 放大 |
| h2 并发 stream | 100–256 | SETTINGS_MAX_CONCURRENT_STREAMS 限制 |
| 握手开销 | 1-RTT,复用可 0-RTT | TLS 1.3 与 QUIC 同级 |
3 实践
3.1 最小示例
一次带条件请求的读取,同时确认协商到的协议版本与各段耗时。
# 带条件请求:命中则 304,避免重复传输
curl -v --http2 https://api.example.com/orders/42 \
-H 'Accept: application/json' -H 'If-None-Match: "v42-7"'
# 计时分解:解析、连接、TLS、首字节各耗多少
curl -s -o /dev/null -w 'dns=%{time_namelookup} tcp=%{time_connect} tls=%{time_appconnect} ttfb=%{time_starttransfer}\n' https://api.example.com/orders/42
一次 304 交互的报文形态,注意 304 没有消息体,但可以更新缓存元数据。
GET /orders/42 HTTP/1.1
Host: api.example.com
Accept: application/json
If-None-Match: "v42-7"
HTTP/1.1 304 Not Modified
ETag: "v42-7"
Cache-Control: private, max-age=0
Vary: Accept, Accept-Encoding
3.2 常用操作与参数
| 操作 | 命令 / 工具 | 说明 |
|---|---|---|
| 看协议版本 | curl -w 输出 http_version | 得到 1.1、2 或 3 |
| 强制版本 | curl --http1.1 / --http2 | 对比排障,确认是否版本相关 |
| 看 h2 帧 | nghttp -v https://host | 观察 HEADERS、DATA、SETTINGS |
| 查 ALPN | openssl s_client -alpn h2,http/1.1 | 排除 TLS 层未协商 |
| 发原始请求 | printf 'GET / HTTP/1.1\r\nHost: x\r\n\r\n' | nc host 80 | 观察 400、431 等协议层拒绝 |
3.3 标准流程
- 先定语义:资源用名词型 URI,动作用方法表达,读用 GET、建用 POST、替换用 PUT、局部改用 PATCH。
- 定状态码契约:成功、校验失败、未认证、无权限、冲突、限流各固定码值,写进文档并纳入监控。
- 选版本:对外 API 以 h2 起步并保留 1.1 回退,高丢包或移动场景再评估 h3。
- 明确中间件行为:列出必须透传的头、必须剥离的头、允许重试的条件。
- 设计幂等与重试:写接口引入幂等键,读接口用指数退避与总预算。
- 接观测并回归:按版本、方法、状态类打点,再用真实代理链抓包确认协议与头。
3.4 与相邻技术的组合
- QUIC / TLS:h3 依赖 QUIC 的 stream 与 TLS 1.3;0-RTT 只适合幂等请求,否则有重放风险。
- CDN 与反向代理:边缘与回源可用不同版本,回源走 1.1 时多路复用在边缘终止,收益不再传递。
- 负载均衡:L7 需要解析头做路由与限流,L4 只按连接转发;端到端 h2 要求两端都支持。
- 缓存与认证:Cache-Control、ETag 与 Vary 共同决定是否回源;token 放 Authorization,Cookie 受 SameSite 与 CORS 约束。
3.5 选型维度
| 维度 | 取值 | 影响 |
|---|---|---|
| 客户端类型 | 浏览器 / 移动端 / 服务端 | 浏览器必须走 ALPN,不能直接假定 h2 |
| 网络质量 | 低丢包 / 高丢包移动网 | 高丢包时 h3 收益最大 |
| 中间件 | 现代 CDN / 老旧代理 | 老旧代理可能不支持 h2 回源或 Upgrade |
| API 风格 | 资源型 / 动作型 | 资源型配方法与状态码,动作型考虑 RPC |
| 重试需求 | 无 / 强 | 强重试需要幂等键与状态码契约 |
3.6 决策规则
- 公开 Web 与 API、需要缓存与 CDN:h2 起步,h3 作为增强并保留 TCP 回退。
- 内网连接数多、延迟敏感:优先 h2 复用连接,避免每请求新建连接。
- 移动端、跨洋链路、丢包明显:灰度 h3,先看失败率与回退比例。
- 写操作需要重试:POST 配幂等键,或改写为 PUT 语义。
- 大文件下载上传:Range 加分块与断点续传,不要一条请求传完。
3.7 替代方案对比
| 方案 | 优势 | 代价 | 适用 |
|---|---|---|---|
| HTTP/1.1 | 兼容性最好、文本可读 | 每源连接数受限、头重复 | 老客户端、简单代理 |
| HTTP/2 | 多路复用、头压缩 | TCP 层队头阻塞、调优复杂 | 现代 Web 与 API |
| HTTP/3 | 丢包不阻塞、握手快、可迁移 | UDP 可能被封、工具较少 | 移动与高丢包链路 |
| WebSocket | 全双工、单连接低开销 | 无内置请求语义与重连 | 实时双向通信 |
3.8 何时不该用
- 需要双向持续推送:请求/响应模型不合适,改用 WebSocket 或 gRPC 流式。
- 超高频内网调用:每次携带完整头的开销仍高于二进制 RPC 或进程内调用。
- 跨资源事务写入:单请求语义无法表达事务,应改批处理接口加补偿。
- 只传大二进制:优先对象存储加预签名 URL,不要穿过应用网关。
4 边界
4.1 典型故障
| 症状 | 根因 | 处理 |
|---|---|---|
| 站点始终回落到 1.1 | ALPN 未协商,或代理终止了 TLS | 检查证书与 CDN 的 h2 开关 |
| h2 下丢包后整体变慢 | TCP 层队头阻塞 | 评估 h3,或拆分连接与域名 |
| 偶发 431 或 400 | 请求头过大,Cookie 与 token 膨胀 | 精简头,调大网关上限 |
| 网关返回 502/504 | 回源协议不匹配或超时 | 对齐回源版本与超时预算 |
| POST 重复创建订单 | 网关自动重试非幂等请求 | 引入幂等键,只重试幂等方法 |
| h3 连接直接失败 | UDP 被防火墙或运营商阻断 | 依赖 Alt-Svc 回退并验证 |
4.2 反模式
| 做法 | 后果 | 替代 |
|---|---|---|
| 用 GET 执行写操作 | 被缓存、预取或爬虫触发写入 | 改用 POST 或 PUT |
| 全部返回 200,错误码放 body | 中间件无法重试、缓存与告警 | 使用语义化状态码 |
| 对 5xx 无限重试 | 故障被放大 | 重试预算加退避与熔断 |
| 依赖 X-Forwarded-For 鉴权 | 头可伪造 | 只在可信跳信任,改用 mTLS 或 JWT |
4.3 可观测信号
按版本、方法、状态类分桶的 QPS、P99 与错误率;ALPN 分布与回源协议比例;4xx/5xx 占比;重试次数与幂等键冲突数;h2 的 RST_STREAM 与 GOAWAY 计数;用分段计时区分解析、连接、TLS 与首字节。
4.4 安全 / 性能 / 一致性边界
- 安全:明文 HTTP 只用于回环或隔离网段;HSTS 防降级;CORS 不能替代服务端鉴权;头与 trailer 都可能被中间件改写,不能当信任边界。
- 性能:多路复用不等于无限并发,流控窗口与并发 stream 上限才是真实瓶颈;头压缩对重复头有效,对随机头几乎无效。
- 一致性:幂等是重试安全的前提,不是结果一致;304 与缓存会带来陈旧读窗口,写后读需绕过缓存或用版本号。
- 演进:h3 必须有 TCP 回退,任何版本升级都要在真实代理链上验证,不能只测直连。