1 / 4概念
HTTP Caching
读完能为每一类响应写出明确的新鲜期、验证器与可见性,并判断“用户看到旧内容”是源站头写错、中间层覆盖还是客户端缓存未过期。也能在版本化 URL、purge 与短 TTL 之间做出可回滚的选择。
1 概念
1.1 一句话定义
HTTP 缓存是源站与缓存之间的一份头字段契约:它规定响应能否被存、能被谁存、在多久之内可以直接复用、过期后如何向源站确认,以及哪些请求维度的差异必须产生不同副本。
1.2 它解决什么问题
- 省掉重复传输:同一资源在有效期内直接复用,省去请求往返与响应体字节。
- 让中间层可安全介入:CDN 与代理只有在明确“可存多久、可给谁”时才敢缓存。
- 把陈旧变成可度量:新鲜期与协商机制把“内容会不会过期”从猜测变成可配置的上限。
- 支撑发布与回滚:版本化 URL 与短 TTL 让发布的影响范围可预测。
1.3 不属于本页的内容
| 主题 | 去哪 |
|---|---|
| 请求方法、状态码与消息语义 | HTTP |
| 边缘节点拓扑、回源与 purge 传播 | CDN |
| Cache API、IndexedDB 与 Service Worker 存储 | Storage |
| 证书与传输加密 | TLS |
| 应用层缓存与数据库缓存 | Data Platforms |
1.4 关键术语
| 术语 | 含义 | 容易混淆的点 |
|---|---|---|
| freshness lifetime | 副本可直接复用的时长 | 不等于字段名,可能被更具体指令覆盖 |
| age | 副本已存活的秒数 | 不是源站的 Date |
| validator | ETag 或 Last-Modified | 不是缓存键的一部分 |
| 条件请求 | 带 If-None-Match 或 If-Modified-Since | 不是每次都回完整响应 |
| private cache | 浏览器内的缓存 | 不受 s-maxage 约束 |
| shared cache | CDN、代理、网关缓存 | 受 s-maxage 与 private 约束 |
| revalidation | 过期后向源站确认 | 不等于重新下载 |
| Vary | 二级缓存键的维度 | 不是 Cache-Control 指令 |
| heuristic freshness | 无显式头时按比例估算 | 不是跨实现一致的行为 |
2 机制
2.1 心智模型
每个缓存条目要回答两个独立问题。第一是“这是不是同一个对象”,由 URI 与 Vary 指定的请求头决定;第二是“它还能不能用”,由新鲜期减去 age 决定。前者错了会把甲的内容给乙,后者错了会让用户看过期页面。
两个问题对应两套动作。键不匹配就查不到、只能回源;键匹配但已过期就走协商,命中 304 时只更新头、不传响应体。理解这两步分开,才能判断一次请求为什么既没有回源也没有更新。
2.2 机制拆解
- 可存性:方法可缓存(GET、HEAD)、状态码默认可缓存、响应没有 no-store,三者同时满足才会被存。
- 建键:URI 加 Vary 列出的请求头;
Vary: *表示永不匹配,等于禁用该响应的缓存。 - 算新鲜期:取 max-age 或 s-maxage 与 Expires 中更严格的一个;没有显式头时用启发式,常见是 Date 与 Last-Modified 差值的 10%。
- 算 age:用 Age 头与本地驻留时间累加,判断剩余可用时间。
- 协商:带 If-None-Match 或 If-Modified-Since 请求;304 必须带回更新后的 Cache-Control、ETag 与 Vary。
- 过期后策略:stale-while-revalidate 先返回旧副本并后台刷新;stale-if-error 在源站 5xx 或超时时继续用旧副本。
- 失效:不安全方法成功后让该 URI 在共享缓存中失效;此外只剩 purge 与换 URL 两条主动路径。
2.3 完整枚举
| 指令 | 作用 | 出现位置 | 注意 |
|---|---|---|---|
| max-age | 相对新鲜期,单位秒 | 响应 | 共享缓存上会被 s-maxage 覆盖 |
| s-maxage | 共享缓存的新鲜期 | 响应 | 隐含 proxy-revalidate 语义 |
| no-cache | 可存储,但复用前必须验证 | 请求与响应 | 不等于“不缓存” |
| no-store | 任何缓存都不得存储 | 请求与响应 | 最严格,会牺牲离线与性能 |
| private | 只允许私有缓存存储 | 响应 | 共享缓存必须当它不存在 |
| public | 明确可被共享缓存存储 | 响应 | 对带认证的响应才有实际作用 |
| must-revalidate | 过期后不得使用旧副本 | 响应 | 源站不可达时直接失败 |
| proxy-revalidate | 同上,但只约束共享缓存 | 响应 | 浏览器仍可能用旧副本 |
| immutable | 新鲜期内不发验证请求 | 响应 | 只适合带指纹的资源 |
| stale-while-revalidate | 过期后窗口内先返回旧副本 | 响应 | 依赖后台刷新真正发生 |
| stale-if-error | 源站错误时返回旧副本 | 响应 | 窗口过长会掩盖真实故障 |
| no-transform | 禁止中间层改写内容 | 响应 | 与图片转换、压缩重写冲突 |
| only-if-cached | 只接受已缓存副本 | 请求 | 未命中返回 504 |
| must-understand | 不认识该指令就不得存储 | 响应 | 常与 no-store 配合 |
2.4 关键数字与量级
| 指标 | 量级 | 说明 |
|---|---|---|
| 指纹静态资源 max-age | 1 年 | 实际靠换 URL 更新 |
| HTML max-age | 0–60 秒 | 长 TTL 会拖慢发布 |
| API 默认 | 不缓存 | 逐用户或强一致 |
| 启发式新鲜期 | Date 与 Last-Modified 差值的 10% | 仅在没有显式头时生效 |
| 304 响应体 | 0 字节 | 但仍携带更新后的头 |
| stale 窗口 | 30–60 秒 | 再长会模糊故障边界 |
| Vary 维度数量 | 1–2 个 | 每多一个维度多一份副本 |
3 实践
3.1 最小示例
# 1. 看源站给的头:有没有显式新鲜期与验证器
curl -sSI https://www.example.com/assets/app.js
# cache-control: public, max-age=300, stale-while-revalidate=60
# etag: "7f3c91-1763788000"
# vary: accept-encoding
# 2. 带验证器再请求:应得到 304,响应体为空
curl -sS -o /dev/null -D - \
-H 'If-None-Match: "7f3c91-1763788000"' \
https://www.example.com/assets/app.js
# HTTP/2 304
# cache-control: public, max-age=300
# 3. 换一个压缩编码:Vary 生效时应是另一个缓存条目
curl -sSI -H 'Accept-Encoding: br' https://www.example.com/assets/app.js | grep -iE 'vary|age|x-cache'
# 4. 60 秒内重复请求,观察 age 是否增长
for i in 1 2 3; do curl -sSI https://www.example.com/assets/app.js | grep -i '^age'; sleep 20; done
# 5. 确认私有响应没有被共享缓存接住
curl -sSI -H 'Authorization: Bearer <token>' https://www.example.com/api/me | grep -i cache-control
# cache-control: private, no-store
3.2 常用操作与参数
| 操作 | 命令 / 配置 | 说明 |
|---|---|---|
| 看响应头 | curl -sSI https://www.example.com/app.js | 先确认有没有显式新鲜期 |
| 强制重新验证 | -H 'Cache-Control: no-cache' | 绕过本地副本 |
| 验证 304 | 带 If-None-Match | 体为空即协商成功 |
| 检查 Vary | 比对不同 Accept-Encoding | 每个维度一份副本 |
| 客户端确认 | DevTools 看 memory 与 disk | 与 CDN 层分开统计 |
3.3 标准流程
- 资源分类:可长期复用、需频繁更新、不可缓存三类,先分类再写头。
- 显式写新鲜期:max-age 与 s-maxage 分别针对私有与共享缓存,不用默认行为。
- 加验证器:静态资源至少一个强 ETag,动态页面至少一个 Last-Modified。
- 决定 Vary:只列真正改变响应体的请求头,压缩编码通常一个就够。
- 规划失效:指纹资源换 URL,HTML 短 TTL,API 不缓存。
- 配 stale 窗口:swr 用于可用性,stale-if-error 只留很短窗口。
- 双端验证:curl 看头,浏览器看来源,再看 CDN 的命中与 304 比例。
3.4 与相邻技术的组合
- CDN:s-maxage 只作用于共享缓存,边缘的 TTL 覆盖策略必须与源站头对齐。
- Storage:Cache API 与 Service Worker 是另一套存储,与 HTTP 缓存不自动同步。
- HTTP:方法可缓存性、状态码与条件请求语义决定规则能否生效。
- Kubernetes:Ingress 的缓存注解可能改写响应头,需要和源站规则一起评审。
3.5 选型维度
| 维度 | 取值 | 影响 |
|---|---|---|
| 资源类型 | 指纹静态 / HTML / API / 个性化 | 决定 TTL 与可缓存性 |
| 缓存位置 | 私有 / 共享 / 两者 | 决定 private 与 s-maxage |
| 新鲜度 | 长 / 短 / 0 | 决定回源比例与陈旧窗口 |
| 验证器 | 强 ETag / 弱 ETag / Last-Modified / 无 | 决定 304 是否可用 |
| 失效方式 | 版本化 URL / purge / 短 TTL | 决定发布的可预测性 |
| 一致性 | 允许陈旧 / 读到即新 | 决定是否使用 no-store |
3.6 决策规则
- 文件名含内容 hash:
max-age=31536000, immutable,不需要任何失效机制。 - HTML 与对外共享的 JSON:
max-age=0, must-revalidate或秒级 s-maxage。 - 逐用户响应:
private, no-store;需要离线能力时改在应用层做。 - 需要抗源站短抖动:swr 给几十秒,stale-if-error 给更短。
- 有 ETag 但没有显式头:不要依赖启发式,显式写 max-age。
- 已经有一层反向代理缓存:用 s-maxage 控制它,而不是 max-age。
3.7 替代方案对比
| 方案 | 优势 | 代价 | 适用 |
|---|---|---|---|
| 版本化 URL | 失效确定、可回滚 | 需构建期支持 | 前端静态资源 |
| purge 接口 | 不改 URL 也能更新 | 传播延迟、可能清不干净 | HTML、配置 |
| 短 TTL | 无需额外机制 | 回源比例高、延迟抖动 | 更新频繁的小文件 |
| Service Worker 缓存 | 可精细控制、支持离线 | 版本管理复杂 | PWA、弱网场景 |
| 应用层缓存 | 不受 HTTP 语义限制 | 需自行失效与保证一致性 | 数据聚合接口 |
3.8 何时不该用
- 响应包含身份或权限差异,且无法按用户分键:共享缓存会直接造成越权。
- 写后立刻读必须一致(下单、支付结果):任何陈旧窗口都不可接受。
- 内容极小且源站就在用户旁边:缓存的收益低于维护成本。
- 一次性令牌、验证码、签名 URL:任何缓存都会破坏其安全性。
4 边界
4.1 典型故障
| 症状 | 根因 | 处理 |
|---|---|---|
| 发布后用户仍看旧页面 | HTML 用了长 max-age | 改短 TTL 或加版本参数 |
| 不同用户拿到同一份内容 | 缺 private,共享缓存接管 | 加 private 或 no-store 并清副本 |
| 改了头但边缘行为不变 | 边缘 TTL 覆盖了源站头 | 对齐供应商的覆盖配置 |
| 304 之后头没更新 | 304 未带更新后的 Cache-Control | 源站补全 304 头 |
| 命中率异常低 | Vary 维度过细或 query 变动 | 收敛 Vary,规范 query |
| 源站故障时页面空白 | must-revalidate 不允许旧副本 | 改用短窗口 stale-if-error |
| 压缩与非压缩内容串版本 | Vary 缺 Accept-Encoding | 补上该维度 |
4.2 反模式
| 做法 | 后果 | 替代 |
|---|---|---|
| 全部资源 no-store | 每次回源,延迟与成本翻倍 | 指纹资源用长 TTL |
| 依赖启发式缓存 | 行为随浏览器与时间漂移 | 显式写新鲜期 |
| 把 no-cache 当作“不缓存” | 仍然存储,且每次都要验证 | 需要不存时用 no-store |
| purge 后不处理浏览器层 | 用户端仍旧看到旧内容 | 换 URL 或缩短 TTL |
4.3 可观测信号
源站应记录 200 与 304 的比例、响应体字节数与 Age 分布;CDN 侧看命中率、按内容类型的回源 QPS、Vary 造成的副本数量。客户端用 DevTools 的 memory、disk、service worker 三个来源分开统计,否则会把浏览器缓存误判成 CDN 问题。
4.4 安全 / 性能 / 一致性边界
- 安全:共享缓存存下带认证的响应就等于越权;private 与按 Authorization 分键是硬要求。
- 性能:命中率提升的收益通常大于任何单次传输优化;但 Vary 过细会让副本数指数增长。
- 一致性:HTTP 缓存只保证“不超过新鲜期的陈旧”,不保证跨副本同时更新;读己之写要靠 no-store 或应用层。
- 隐私:age 与命中状态都是可观测信号,日志中不应记录带敏感参数的完整 URL。