HTTP 协议核心参考手册
适用于日常开发、接口设计、面试复习、问题排查
最后更新:2026 年
目录
- HTTP 请求方法
- HTTP 版本与连接演进
- 数据提交/传参方式
- 常用状态码速查
- 常用请求/响应头
- 最佳实践与避坑指南
- 调试工具与命令
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> |
❌ |
请求体示例对比
POST /login HTTP/1.1
Content-Type: application/x-www-form-urlencoded
Content-Length: 29
username=admin&password=123456
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 安全清单
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 方法语义速记
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 参考