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、前缀还是标签、生效延迟多长,属于必须实测确认的项;在没有可复现记录之前,不宜把它当作已具备的能力写进方案。
上线前可自行完成的自检#
- 抓一次响应头,核对
Cache-Control是否与设计一致,是否被中间层改写。 - 分别以不同
Accept-Encoding、Accept-Language请求,检查Vary是否覆盖这些维度。 - 记录首次响应与随后请求的
Age,确认剩余新鲜期符合预期。 - 构造条件请求,确认内容未变时返回 304、变化后返回 200 与新
ETag。 - 灰度期先给短 TTL,稳定后再放宽,避免第一次就把过期时间写死。
落到 API.PLUS 的具体配置,仍需要其文档正文支撑;在此之前,上述检查项都可以在本地或自建网关侧先做完。