HTTP 缓存与 CDN 加速实践:先定缓存键,再谈边缘加速(2026-11-16)
加速的前提不是节点数量,而是先把“哪些请求算同一个资源”定下来。缓存键过窄会让命中率失去意义,过宽则把不该共享的内容共享出去;先列清影响响应的请求维度,再决定 Cache-Control、Vary 与校验策略,最后才是边缘分发。
如果你的接口已经接上 CDN,但命中率仍然不理想,或者相反,出现了不该出现的串内容问题,先不要调 TTL。更常见的根因是:缓存键还没有被定义清楚。缓存键是缓存用来判断“这次请求能不能复用上一次响应”的依据,它决定了缓存系统的全部后续行为。键定不下来,边缘节点越多,错误被复制的范围反而越大。
缓存键的作用#
在 HTTP 语义中,共享缓存(CDN、反向代理)与私有缓存(浏览器)处理同一响应的规则并不相同。缓存键通常至少包含请求方法和完整 URL(含查询字符串);Vary 响应头则声明哪些请求头字段额外参与键的构成。这带来两个方向相反的风险:
- 键过窄:URL 里混入与内容无关的追踪参数,或每次请求都带随机数,那么每次都是一次未命中,缓存层只是多了一跳转发。
- 键过宽:影响响应体的因素(语言、内容协商、登录身份)没有进入键,不同用户会拿到同一份响应。这不是性能问题,而是正确性和数据边界问题。
因此顺序是:先把请求事实分类,再谈边缘加速。
把请求维度分成三类#
| 类别 | 典型例子 | 处理方式 |
|---|---|---|
| 影响响应体的 | 路径、分页与筛选参数、语言、内容类型协商 | 进入缓存键;若走请求头则用 Vary 声明 |
| 影响可缓存性的 | 请求方法、Authorization、Cookie | 通常不进入键,而是约束“能不能被共享缓存存储” |
| 不影响内容的 | 归因、埋点类查询参数 | 从键中剔除,否则命中率被稀释 |
第三类最容易被忽略。同一份商品列表,带上来源参数后变成十个 URL,共享缓存就退化成了十份各自冷启动的副本。
Vary 的边界
Vary 只应列出真正会改变响应体的头部字段。声明过多字段的副作用是键空间膨胀;而 Vary: * 对共享缓存而言基本等价于“不要复用”。另外,Vary 与 Authorization、Cookie 的组合行为在不同实现间存在差异,具体结论待核实,需要以你所用 CDN 的文档为准。
Cache-Control 中容易混淆的几项#
| 指令 | 含义 | 常见误用 |
|---|---|---|
max-age | 响应在多少秒内被视为新鲜 | 只调大它,却不处理内容更新后的失效路径 |
s-maxage | 仅对共享缓存生效,覆盖 max-age | 以为它会同时压缩浏览器缓存时间 |
no-cache | 可以存储,但每次使用前必须向源站校验 | 误当成“不要缓存”;真正的“不要存”是 no-store |
private | 只允许私有缓存保存 | 在需要共享加速的接口上误用,命中率归零 |
public | 允许共享缓存保存,即使请求带了认证信息(在实现支持的前提下) | 在含用户数据的响应上随手添加 |
带 Authorization 的请求在共享缓存中的默认行为、以及 public 能否覆盖该默认值,取决于缓存实现。发布前请在目标环境确认,本文不代为断言。
一份响应头示意(未执行示例)#
下面是演示用的响应头形状,不代表任何厂商的配置语法,也未经实际请求验证:
HTTP/1.1 200 OK
Cache-Control: public, max-age=60, s-maxage=300
Vary: Accept-Language
ETag: "demo-etag-value"
含义上,浏览器最多复用 60 秒,共享缓存最多复用 300 秒,语言不同则视为不同资源;超过新鲜期后通过 ETag 做条件校验。是否启用 stale-while-revalidate 这类扩展指令,取决于缓存端支持程度,待核实。
上线前的核对顺序#
- 列出接口的全部输入,按上表分成三类,明确哪些必须进键。
- 检查查询参数是否有可剔除的噪声项,以及参数顺序是否会造成同一资源的多种写法。
- 确定新鲜期与校验方式(
ETag或Last-Modified),并写出内容更新时的失效路径。 - 用响应头观察实际结果,例如查看
Age是否随命中增长(命令为未执行示例):
curl -sI "https://api.example.com/v1/items?page=2"
不同 CDN 用于标识命中状态的头部字段名并不统一,需查阅对应文档,此处不做推测。
适用条件与待核实项#
以上讨论适用于可被共享缓存的 GET 类资源,且响应内容与请求者身份无关。对于个性化、写操作或实时性要求高的接口,主要问题不是缓存键,而是能否缓存——这需要单独判断。
关于 API.PLUS 平台自身的默认缓存键构成、边缘节点行为、缓存清除接口与配额,本次材料未提供,均待核实;在没有官方说明前,不宜按某一具体实现来设计键结构。