技术文章

外部链接将在新标签页打开。

HTTP 缓存与 CDN 加速实践:先定缓存键,再谈命中率

一句话回答

缓存能否加速取决于三个前提:响应被声明为可缓存、缓存键覆盖所有影响内容的请求头、失效路径闭合。文章按私有缓存与共享缓存的分工说明 Cache-Control 的方向性,给出最小响应头字段及各自职责,指出查询参数、Accept-Encoding 与 Authorization、Cookie 是缓存键最易出错处,并对比 TTL、ETag 验证、主动清除三种失效手段的代价。涉及 API.PLUS 的具体配置项与默认值,本次无文档正文,均标注待核实。

核心要点 TL;DR
  • 只有当响应被声明为可缓存、缓存键覆盖全部变体维度、失效路径闭合时,缓存才会真正提速;缺一项就会出现部分用户读到旧数据。
  • Vary 漏写或查询参数带随机值,是命中率骤降与内容串号的两个常见原因。
  • TTL、ETag 验证、主动清除三种失效手段代价不同,要做到“发布即可见”不能只靠 TTL。

缓存能不能带来加速,取决于三个可验证的前提:响应是否被明确声明为可缓存、缓存键是否覆盖了所有会影响内容的请求头、失效之后的路径是否闭合。三者缺一,加速就会变成“部分用户看到旧数据”。本次没有 API.PLUS 的接口文档正文,因此涉及该平台的具体缓存配置项、默认 TTL 与开关位置,需以官方文档为准(待核实);下文只讨论协议层面开发者可自行验证的部分。

先分清谁在缓存#

同一个响应可能停在三个位置,它们的权限不一样:

  • 浏览器私有缓存:只服务单个用户,可以保存含个人数据的响应。
  • 共享缓存(CDN、反向代理):一份响应服务多用户,个人化内容一旦进入就是数据事故。
  • 源站或应用层缓存:不属于 HTTP 缓存语义,但决定回源频率与源站压力。

Cache-Control 的方向性正来自这里:private 只允许私有缓存存储,public 才允许共享缓存存储。

一条最小可用的响应头#

HTTP/1.1 200 OK
Content-Type: application/json
Cache-Control: public, max-age=60, s-maxage=300, stale-while-revalidate=30
ETag: "v42"
Vary: Accept-Encoding, Accept-Language
Age: 12

以上为示意,使用占位值,未实际发送或抓取。各字段职责:

字段作用常见误用
max-age私有缓存的新鲜期以为它同时约束 CDN
s-maxage覆盖共享缓存的新鲜期,优先级高于 max-age与 max-age 写成同一个值,失去分层意义
ETag供条件请求验证,命中返回 304按时间戳生成,每次请求都不同
Vary声明缓存键额外维度漏写或维度过多
Age由缓存添加,表示已存放时长源站自己写死

304 节省的是响应体带宽,不是一次往返;它降低传输成本,但不降低延迟。

缓存键与 Vary:最容易出错的一段#

  • 查询参数通常进入缓存键。形如 ?_t=... 的防缓存随机值会让命中率趋近于零,前端这一写法值得先审一遍。
  • 内容协商必须显式声明。若仅因 Accept-Encoding 返回不同表示,Vary 漏写就可能把压缩内容发给不支持的客户端。
  • 带 Authorization 的请求,共享缓存默认不存储对应响应,除非响应显式允许(如 public 或 s-maxage),且前提是该响应确实与用户无关。具体条款以 HTTP 缓存规范 RFC 9111 为准。
  • 带 Set-Cookie 的响应一般不应被共享缓存存储,否则会话标识会被分发。

失效:三种手段,代价不同#

手段生效范围代价
TTL 自然到期所有缓存层最长要等到 TTL 结束
ETag 条件验证逐次请求多一次往返
主动清除(purge)需各层支持支持粒度与生效延迟视服务商而定(待核实)

要做到“发布即可见”,纯 TTL 不够用。清除能力是否提供、粒度是单 URL、前缀还是标签、生效延迟多长,属于必须实测确认的项;在没有可复现记录之前,不宜把它当作已具备的能力写进方案。

上线前可自行完成的自检#

  1. 抓一次响应头,核对 Cache-Control 是否与设计一致,是否被中间层改写。
  2. 分别以不同 Accept-Encoding、Accept-Language 请求,检查 Vary 是否覆盖这些维度。
  3. 记录首次响应与随后请求的 Age,确认剩余新鲜期符合预期。
  4. 构造条件请求,确认内容未变时返回 304、变化后返回 200 与新 ETag。
  5. 灰度期先给短 TTL,稳定后再放宽,避免第一次就把过期时间写死。

落到 API.PLUS 的具体配置,仍需要其文档正文支撑;在此之前,上述检查项都可以在本地或自建网关侧先做完。

作者:沐小悠

本文约 4 分钟读完 · 关键词:HTTP 缓存、CDN 加速、Cache-Control、ETag、Vary

更多文章 GET 示例接口

「」标签下的其他文章