← 返回首页
HTTP 协议核心参考手册

HTTP 协议核心参考手册

发布于 2026年11月10日 21:15⏱ 3 分钟阅读👁 9

适用于日常开发、接口设计、面试复习、问题排查

HTTP 协议核心参考手册

适用于日常开发、接口设计、面试复习、问题排查
最后更新:2026 年


目录

  1. HTTP 请求方法
  2. HTTP 版本与连接演进
  3. 数据提交/传参方式
  4. 常用状态码速查
  5. 常用请求/响应头
  6. 最佳实践与避坑指南
  7. 调试工具与命令

1. HTTP 请求方法

方法 语义 幂等性 安全性 请求体 典型场景 缓存
GET 获取资源 ✅ 是 ✅ 是 ❌ 无 查询列表、详情、搜索 ✅ 可缓存
POST 提交/创建资源 ❌ 否 ❌ 否 ✅ 有 表单提交、文件上传、创建记录 ❌ 不缓存
PUT 整体替换资源 ✅ 是 ❌ 否 ✅ 有 完整更新用户信息、配置覆盖 ❌ 不缓存
DELETE 删除资源 ✅ 是 ❌ 否 可选 删除记录、注销账号 ❌ 不缓存
PATCH 局部更新资源 ❌ 否* ❌ 否 ✅ 有 修改头像、更新单个字段 ❌ 不缓存
HEAD 仅获取响应头 ✅ 是 ✅ 是 ❌ 无 检查资源是否存在、获取元数据 ✅ 可缓存
OPTIONS 查询支持的方法 ✅ 是 ✅ 是 可选 CORS 预检、探测接口能力 ❌ 不缓存
TRACE 回显请求路径 ✅ 是 ✅ 是 ❌ 无 诊断代理/网关转发路径 ❌ 不缓存
CONNECT 建立隧道 ❌ 否 ❌ 否 ❌ 无 HTTPS 代理隧道建立 ❌ 不缓存

⚠️ 注意:PATCH 在 RFC 5789 中定义为非幂等,但实际实现可设计为幂等(如 JSON Merge Patch)。

幂等性 vs 安全性

  • 安全性:不修改服务器状态(GET、HEAD、OPTIONS、TRACE)
  • 幂等性:多次执行结果一致(GET、HEAD、PUT、DELETE、OPTIONS、TRACE)
  • 实际开发建议:
    • 查询操作必须用 GET
    • 创建用 POST,完整更新用 PUT,部分更新用 PATCH
    • 幂等接口便于重试、网关幂等键设计

2. HTTP 版本与连接演进

版本对比总览

特性 HTTP/1.0 HTTP/1.1 HTTP/2 HTTP/3
RFC RFC 1945 RFC 7230-7235 RFC 7540 RFC 9114
传输层 TCP TCP TCP UDP (QUIC)
连接模式 短连接 长连接 长连接+多路复用 0-RTT 连接+多路复用
请求方式 文本明文 文本明文 二进制分帧 二进制分帧
头部压缩 ❌ 无 ❌ 无 ✅ HPACK ✅ QPACK
服务器推送 ❌ 无 ❌ 无 ✅ 支持 ✅ 支持
队头阻塞 严重 (应用层) 缓解 (管道化不完善) 存在 (TCP 层) 彻底解决 (流级别)
握手延迟 3-RTT (TCP+TLS) 2-3-RTT 2-3-RTT 0-1 RTT
连接迁移 ❌ 不支持 ❌ 不支持 ❌ 不支持 ✅ 支持 (Connection ID)
默认端口 80 80 443 (通常走 TLS) 443 (UDP)

关键演进节点

HTTP/1.0 → 1.1

  • Connection: keep-alive 成为默认
  • 新增 Host 头 → 虚拟主机支持
  • 分块传输编码 (Transfer-Encoding: chunked)
  • 管道化 但存在队头阻塞、难以部署

HTTP/1.1 → 2

  • 二进制分帧层:HEADERS/DATA/SETTINGS/PING 帧
  • 多路复用:单连接并行多个流
  • HPACK 头部压缩:静态表+动态表+Huffman 编码
  • 服务器推送:PUSH_PROMISE 帧(现已废弃,推荐 Preload/103 Early Hints)
  • 流优先级:依赖树 + 权重

HTTP/2 → 3 (QUIC)

  • 传输层替换:TCP → UDP + QUIC 协议栈
  • 内置 TLS 1.3:0-RTT 恢复会话
  • 流级可靠性:丢包只阻塞该流,不影响其他流
  • 连接迁移:网络切换 (WiFi↔5G) 不断连
  • 前向纠错 (FEC):可选冗余包恢复丢包

版本选择建议

场景 推荐版本
现代 Web 应用、API HTTP/2 + TLS (最广泛部署)
移动端、弱网、高丢包 HTTP/3 (QUIC 优势明显)
老旧客户端兼容 HTTP/1.1 (保底)
内网微服务、gRPC 场景 HTTP/2 (h2c 明文) 或 gRPC over HTTP/2

💡 Nginx/Apache/Caddy/CDN 均已支持 HTTP/3,开启通常只需配置 listen 443 quic 或 http3 on。


3. 数据提交 / 传参方式

四大主流 Content-Type

Content-Type 编码方式 适用场景 请求体示例 文件上传
application/x-www-form-urlencoded 键值对 key=val&key2=val2 简单表单、登录、搜索 username=admin&password=123 ❌ 不支持
multipart/form-data 分隔符 boundary 分割字段 文件上传、混合表单 见下文示例 ✅ 支持
application/json JSON 字符串 REST API、复杂对象、前后端分离 {"name":"张三","age":25} ❌ 需 Base64
text/xml / application/xml XML 文档 老旧 SOAP、企业级集成 <user><name>张三</name></user> ❌

请求体示例对比

application/x-www-form-urlencoded

POST /login HTTP/1.1
Content-Type: application/x-www-form-urlencoded
Content-Length: 29
 
username=admin&password=123456

multipart/form-data (文件上传)

POST /upload HTTP/1.1
Content-Type: multipart/form-data; boundary=----WebKitFormBoundary7MA4YWxkTrZu0gW
Content-Length: 642
 
------WebKitFormBoundary7MA4YWxkTrZu0gW
Content-Disposition: form-data; name="avatar"; filename="photo.jpg"
Content-Type: image/jpeg
 
<二进制文件内容>
------WebKitFormBoundary7MA4YWxkTrZu0gW
Content-Disposition: form-data; name="userId"
 
1001
------WebKitFormBoundary7MA4YWxkTrZu0gW--

application/json (现代 API 标准)

POST /api/users HTTP/1.1
Content-Type: application/json
Content-Length: 58
 
{"name": "张三", "email": "zhangsan@example.com", "roles": ["user"]}

传参位置对比

位置 方法 编码 长度限制 安全性 典型用途
URL Query String GET/HEAD URL Encoding ~2KB (浏览器/服务器) 低 (日志/历史记录可见) 筛选、分页、搜索、幂等查询
Path Parameter 所有 URL Encoding 受 URL 总长限制 低 RESTful 资源定位 /users/1001
Request Body POST/PUT/PATCH 视 Content-Type 服务器配置 (默认 ~1-10MB) 高 (不记录在日志/历史) 创建、更新、复杂查询、文件
Header 所有 Token/Base64 单头 ~8KB 中 认证、版本、幂等键、追踪 ID
Cookie 所有 Cookie 格式 单 Cookie 4KB、域 20+ 个 中 会话识别、CSRF Token

⚠️ 安全提醒:敏感数据 (密码、Token、PII) 严禁放在 URL、Header (除 Authorization)、Cookie (除 HttpOnly Secure) 中。


4. 常用状态码速查

1xx 信息响应

码 含义 场景
100 Continue 大请求体预检 (Expect: 100-continue)
101 Switching Protocols WebSocket 升级、HTTP/2 升级
103 Early Hints 预加载关键资源 (Link: preload)

2xx 成功

码 含义 典型场景
200 OK GET/POST/PUT/PATCH 成功返回数据
201 Created POST 创建资源成功,返回 Location 头
202 Accepted 异步任务已受理 (批量导入、视频转码)
204 No Content DELETE 成功、PUT/PATCH 无返回体
206 Partial Content 断点续传、视频流、Range 请求

3xx 重定向

码 含义 典型场景
301 Moved Permanently 域名迁移、HTTPS 强制跳转 (SEO 传递权重)
302 Found 临时重定向、登录后跳回原页
304 Not Modified 协商缓存命中 (If-None-Match/If-Modified-Since)
307 Temporary Redirect 保持方法/Body 重定向 (POST→POST)
308 Permanent Redirect 保持方法/Body 永久重定向

4xx 客户端错误

码 含义 典型场景 & 处理建议
400 Bad Request 参数校验失败、JSON 解析错 → 返回详细字段错误
401 Unauthorized 未登录/Token 过期 → 前端跳登录、刷新 Token
403 Forbidden 无权限 (RBAC/ABAC 拒绝) → 提示联系管理员
404 Not Found 资源不存在 → 统一错误页、API 返回空对象
405 Method Not Allowed 方法不支持 → 返回 Allow 头
409 Conflict 版本冲突、重复键 → 乐观锁重试、幂等键去重
413 Payload Too Large 上传超限 → 前端分片、压缩
415 Unsupported Media Type Content-Type 错误 → 检查请求头
422 Unprocessable Entity 语义校验失败 (WebDAV/REST 常用) → 字段级错误
429 Too Many Requests 限流 → 返回 Retry-After、指数退避

5xx 服务端错误

码 含义 典型场景 & 处理建议
500 Internal Server Error 未捕获异常 → 记录完整堆栈、告警、返回通用错误码
502 Bad Gateway 网关/代理转发失败 (上游挂了/超时) → 检查上游健康、超时配置
503 Service Unavailable 维护窗口、过载熔断 → 返回 Retry-After、降级页面
504 Gateway Timeout 网关等待上游超时 → 调大超时、优化上游、异步化

5. 常用请求 / 响应头

请求头

头字段 说明 示例
Host 目标主机 (HTTP/1.1 必须) api.example.com
User-Agent 客户端标识 Mozilla/5.0... / PostmanRuntime/7.29.0
Accept 可接受的响应媒体类型 application/json, text/html;q=0.9
Accept-Encoding 支持的压缩算法 gzip, deflate, br, zstd
Accept-Language 首选语言 zh-CN,zh;q=0.9,en;q=0.8
Authorization 认证凭证 Bearer eyJhbGciOi... / Basic base64(user:pass)
Content-Type 请求体媒体类型 application/json; charset=utf-8
Content-Length 请求体字节长度 1024
Transfer-Encoding 分块传输 chunked
Cookie 携带 Cookie session_id=abc; theme=dark
Origin 发起请求的源 (CORS) https://app.example.com
Referer 来源页面 https://app.example.com/dashboard
X-Request-ID / Traceparent 链路追踪 ID req-20240115-abc123 / 00-0af7651916cd43dd8448eb211c80319c-b7ad6b7169203331-01
Idempotency-Key 幂等键 (业务层) idem-20240115-order-1001
If-None-Match / If-Modified-Since 协商缓存条件 W/"abc123" / Wed, 15 Jan 2024 08:00:00 GMT
Range 断点续传/分片 bytes=0-1023

响应头

头字段 说明 示例
Content-Type 响应体媒体类型 application/json; charset=utf-8
Content-Length 响应体长度 (非分块) 2048
Transfer-Encoding 分块传输 chunked
Content-Encoding 响应体压缩 gzip / br / zstd
Cache-Control 缓存策略 public, max-age=3600 / no-store / no-cache, must-revalidate
ETag 资源实体标签 (强/弱) "abc123" / W/"abc123"
Last-Modified 最后修改时间 Wed, 15 Jan 2024 08:00:00 GMT
Expires 过期时间 (HTTP/1.0) Thu, 16 Jan 2024 08:00:00 GMT
Set-Cookie 下发 Cookie session=abc; HttpOnly; Secure; SameSite=Lax; Path=/
Location 重定向/创建资源地址 /users/1001 / https://new.example.com
Access-Control-Allow-Origin CORS 允许源 https://app.example.com / *
Access-Control-Allow-Methods 允许方法 GET, POST, PUT, DELETE, OPTIONS
Access-Control-Allow-Headers 允许头 Content-Type, Authorization, X-Request-ID
Access-Control-Max-Age 预检缓存时间 86400
Retry-After 重试等待秒数/时间 60 / Wed, 15 Jan 2024 08:10:00 GMT
X-Content-Type-Options 禁止 MIME 嗅探 nosniff
X-Frame-Options 防点击劫持 DENY / SAMEORIGIN
Content-Security-Policy CSP 策略 default-src 'self'; script-src 'self' cdn.example.com
Strict-Transport-Security HSTS 强制 HTTPS max-age=31536000; includeSubDomains; preload
Server 服务器软件 (建议隐藏/模糊) nginx / Caddy / MyApp/1.0

6. 最佳实践与避坑指南

6.1 API 设计规范

# RESTful 资源命名
GET    /api/v1/users              # 列表 (分页、筛选、排序)
POST   /api/v1/users              # 创建
GET    /api/v1/users/{id}         # 详情
PUT    /api/v1/users/{id}         # 整体更新
PATCH  /api/v1/users/{id}         # 部分更新
DELETE /api/v1/users/{id}         # 删除
POST   /api/v1/users/{id}/avatar  # 子资源动作 (上传头像)

响应统一结构

{
  "code": 0,                    // 业务码: 0=成功, 非0=失败类型
  "message": "success",         // 人类可读信息
  "data": { ... },              // 业务数据 (对象/数组/基本类型)
  "traceId": "req-20240115-xxx" // 链路追踪 ID
}

分页标准

{
  "code": 0,
  "data": {
    "items": [...],
    "pagination": {
      "page": 1,
      "pageSize": 20,
      "total": 100,
      "totalPages": 5
    }
  }
}

6.2 幂等性设计

场景 方案
创建订单、支付回调 客户端生成 Idempotency-Key,服务端 Redis SETNX 存结果,TTL 24h
幂等 GET 天然幂等,配合 ETag/Last-Modified 协商缓存
幂等 PUT/DELETE 资源标识唯一,天然幂等
非幂等 POST 必须配合幂等键或业务去重 (如唯一索引)

6.3 缓存策略决策树

资源是否可缓存?
├─ 否 → Cache-Control: no-store, private, must-revalidate
└─ 是 → 是否强制一致性要求高?
     ├─ 是 → Cache-Control: no-cache, must-revalidate + ETag/Last-Modified
     └─ 否 → 可接受短期过期?
          ├─ 是 → Cache-Control: public, max-age=300, stale-while-revalidate=60
          └─ 否 → Cache-Control: public, max-age=3600, immutable (静态资源加 hash)

6.4 安全清单

  • HTTPS 全站强制 (HSTS + 证书透明度监控)
  • Cookie 安全属性:HttpOnly; Secure; SameSite=Lax/Strict
  • CSP 策略:禁止内联脚本、限制外部源
  • CORS 最小权限:不使用 * 配合凭证,明确列出 Origin
  • 限流分层:网关 (IP/用户) + 应用 (业务接口) + 数据库 (连接池)
  • 输入校验:白名单、长度、类型、格式、XSS/SQLi 防护
  • 错误信息脱敏:生产环境不返回堆栈、SQL、内部路径
  • 安全头完整:X-Content-Type-Options: nosniff, X-Frame-Options: DENY, Referrer-Policy: strict-origin-when-cross-origin

6.5 性能优化清单

优化点 手段 预期收益
连接复用 HTTP/2、Keep-Alive、连接池 减少握手延迟 50-200ms
压缩 Brotli (br) > gzip,启用 Accept-Encoding 响应体积 -70%~80%
缓存 CDN + 浏览器缓存 + 协商缓存 + 服务端缓存 (Redis) 吞吐量 10x+
多路复用 HTTP/2/3 单域名并行请求 页面加载 -30%~50%
预加载 <link rel="preload">、103 Early Hints 关键资源并行下载
流式响应 Transfer-Encoding: chunked、SSE、WebSocket 首屏数据提前到达
域名分片/合并 HTTP/1.1 分域名并行;HTTP/2/3 合并域名 适配协议特性

7. 调试工具与命令

7.1 命令行工具

# curl 常用组合
curl -v -X POST "https://api.example.com/users" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Idempotency-Key: idem-001" \
  -d '{"name":"张三"}' \
  --compressed \
  --http2 \
  -w "\nHTTP %{http_code} | Total: %{time_total}s | Connect: %{time_connect}s | TTFB: %{time_starttransfer}s\n"
 
# 仅看响应头
curl -I https://api.example.com/users/1
 
# 断点续传测试
curl -H "Range: bytes=0-1023" -o part1.bin https://cdn.example.com/video.mp4
 
# 跟随重定向 + 显示过程
curl -L -v https://short.url/abc
 
# HTTP/3 测试 (需 curl 7.66+ 编译支持 QUIC)
curl --http3 https://cloudflare-quic.com/
# httpie (更人性化)
http -v POST api.example.com/users name=张三 email=zhang@example.com Authorization:"Bearer $TOKEN"
 
# 文件上传
http -f POST api.example.com/upload avatar@photo.jpg userId=1001

7.2 抓包分析

# tcpdump 抓取 HTTP/HTTPS (需配合密钥解密 TLS)
tcpdump -i eth0 -nn -s 0 -w capture.pcap port 80 or port 443
 
# Wireshark 过滤器
http.request.method == "POST" && http.contains "password"
tls.handshake.type == 1  # Client Hello
quic.long.packet_type == 0  # Initial packet

7.3 浏览器开发者工具

面板 核心用法
Network 按类型筛选 (Fetch/XHR/JS/CSS/Img);查看 Timing (Queueing/Stalled/DNS/TCP/TLS/TTFB/Content);导出 HAR
Console fetch() 调试、查看 CSP 报错、Cookie 读写
Application 查看/编辑 Cookie、LocalStorage、SessionStorage、Cache Storage、Service Worker
Security 证书链、混合内容、HSTS 状态

7.4 在线测试工具

工具 用途
HTTP Status Cats/Dogs 状态码趣味记忆
Web.dev Measure Core Web Vitals、HTTP/2/3 检测
SSL Labs Test TLS 配置评分
Security Headers 安全头完整性扫描
RedBot 缓存合规性检查
h2spec HTTP/2 协议一致性测试

附录:快速参考卡片

HTTP 方法语义速记

GET    = 读 (Read)      🔍
POST   = 创建 (Create)  ➕
PUT    = 替换 (Replace) 🔄
PATCH  = 改 (Modify)    ✏️
DELETE = 删 (Delete)    🗑️
HEAD   = 头 (Head)      📋
OPTIONS= 选 (Options)   ❓

Content-Type 选择口诀

表单键值  → x-www-form-urlencoded
文件上传  → multipart/form-data
JSON 对象 → application/json
老旧 SOAP → text/xml

缓存策略口诀

不缓存       → no-store
必须再验证   → no-cache + ETag
可缓存可过期 → max-age + stale-while-revalidate
静态资源     → max-age=31536000 + immutable + 文件名带 hash

CORS 核心三头

Access-Control-Allow-Origin   → 谁能访问
Access-Control-Allow-Methods  → 能用什么方法
Access-Control-Allow-Headers  → 能带什么头
预检缓存                    → Max-Age 秒数

更新日志

版本 日期 变更
1.0 2025-01-15 初版:方法、版本、传参、状态码、头、最佳实践、调试工具
1.1 2025-06-20 新增:HTTP/3 QUIC 细节、幂等键设计、CSP/HSTS、zstd 压缩、103 Early Hints
1.2 2025-11-10 优化:表格排版、决策树、速记卡片、在线工具链接

📌 收藏建议:将此文件保存为 http-reference.md 放入项目 docs/ 或个人知识库,配合编辑器 Markdown 预览/大纲功能随时检索。
🔗 配套资源:RFC 9110 (HTTP Semantics) | RFC 9114 (HTTP/3) | MDN HTTP 参考


评论 (0)

还没有评论,来写第一条吧~

写评论