技术文章

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

HTTP 缓存与 CDN 加速:先定义可缓存性,再谈命中率

一句话回答

HTTP 缓存语义由响应头决定:s-maxage 管共享缓存(CDN),max-age 管浏览器;带 Authorization 的请求在共享缓存中默认不被存储,加 public 前须确认内容可公共复用;Vary 要写实际协商维度。CDN 加速的收益集中在静态资源与可公共复用的读接口,个性化与写接口应保持不缓存。具体 CDN 产品的默认行为与指令支持范围需查对应文档,本次未联网核验。

核心要点 TL;DR
  • s-maxage 只作用于共享缓存并覆盖 max-age,是控制 CDN 新鲜期的正确位置。
  • 带 Authorization 的请求,共享缓存默认不存储其响应;随意加 public 会把用户数据发给其他用户。
  • Vary 漏写会串内容,写得过宽会让缓存碎片化,两者都降低命中质量。

把接口放到 CDN 后面之前,先回答一个问题:这个响应在什么条件下、对谁可以复用。回答不了,CDN 不会加速正确性,只会让错误的响应传播得更快、更远。本文只讨论 HTTP 缓存语义与 CDN 配置的一般做法;具体 CDN 产品对扩展指令的支持范围与默认行为,需以对应厂商文档为准,本次未联网核验。

可缓存性由响应头决定,不由 URL 决定#

HTTP 缓存语义定义在 RFC 9111 中。缓存分两类:私有缓存(浏览器)与共享缓存(CDN、反向代理)。同一个响应头,在两层里可能得到不同结果,这是 API 场景下最容易搞混的地方。

字段作用API 场景注意
max-age新鲜期,私有与共享缓存都遵守主要影响浏览器端
s-maxage只作用于共享缓存,并覆盖 max-age控制 CDN 新鲜期的正确位置
no-store不存储,含敏感数据鉴权、一次性 token 的响应
private禁止共享缓存存储个性化读接口的默认选择
ETag校验器,支持条件请求与 304降低重复传输体积,不降低请求数
Vary声明内容随哪些请求头变化漏写串内容,过宽碎缓存
Age该副本在共享缓存中已存多久排障时判断是否命中

API 响应最常见的三个错误#

  1. 把带身份的响应放进共享缓存。按 RFC 9111 的规定,带 Authorization 请求头的请求,共享缓存默认不存储其响应,除非响应显式给出允许条件(如 public、s-maxage、must-revalidate 之一)。为了提命中率顺手加 public,就等于把用户 A 的响应发给了用户 B。
  2. Vary 写漏或写宽。内容随 Accept-Encoding、语言、API 版本变化时,这些维度必须进 Vary;反过来写 Vary: User-Agent 几乎等于让每条 UA 单独一份副本,命中率快速下降。
  3. 忽略缓存键的实际构成。缓存键通常由完整 URL 决定,查询串顺序、无意义的追踪参数、末尾斜杠都会造成多份副本。需要在边缘归一的地方提前归一,而不是事后抱怨命中率低。

一个可回退的起点(未执行的示例)#

下面是一个公共只读接口的响应头形态,仅是示例,未实际执行或验证。它让浏览器每次用 ETag 校验换取 304,CDN 在 5 分钟内直接返回缓存副本。

HTTP/1.1 200 OK
Cache-Control: public, max-age=0, s-maxage=300, stale-while-revalidate=30
ETag: "v1-abc"
Vary: Accept-Encoding, Accept-Language

stale-while-revalidate 属于扩展指令,是否被所用缓存实现支持需要核对对应文档,此处不作结论。若你的 CDN 不支持它,去掉该指令不影响其余语义。

验证时别只看命中率#

  • 看响应里的 Age 与缓存层附加的命中标记,确认到底命中了哪一层,而不是只看总命中率。
  • 发布变更后主动清除相关键,并确认清除是全局生效还是按节点生效。
  • 把带身份与不带身份的请求各跑一遍,检查响应体是否串。这一步比调参数更能暴露问题。

边界:什么不该走共享缓存#

鉴权接口、一次性 token、账户状态、实时余额这类内容,应保持 private, no-store。CDN 加速的主要收益来自静态资源与可公共复用的读接口;写接口和个性化接口本来就不该缓存,它们的优化点在数据库、上游超时与连接复用上。把不该缓存的东西配成可缓存,换来的命中率提升是负收益。

||DSML||parameter>

常见问题(FAQ)

max-age 和 s-maxage 同时写会怎样?
共享缓存(CDN、反向代理)优先用 s-maxage,浏览器等私有缓存用 max-age。两者可以同时出现,用于给不同层设置不同新鲜期。
加了 CDN 后接口返回了其他用户的数据,先查什么?
先查带 Authorization 的响应是否被加了 public 或 s-maxage,使共享缓存存储了本应私有的响应。按 RFC 9111,这类请求默认不被共享缓存存储,除非响应显式允许。

作者:沐小悠

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

更多文章 GET 示例接口

「」标签下的其他文章