技术文章

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

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 这类扩展指令,取决于缓存端支持程度,待核实。

上线前的核对顺序#

  1. 列出接口的全部输入,按上表分成三类,明确哪些必须进键。
  2. 检查查询参数是否有可剔除的噪声项,以及参数顺序是否会造成同一资源的多种写法。
  3. 确定新鲜期与校验方式(ETag 或 Last-Modified),并写出内容更新时的失效路径。
  4. 用响应头观察实际结果,例如查看 Age 是否随命中增长(命令为未执行示例):
curl -sI "https://api.example.com/v1/items?page=2"

不同 CDN 用于标识命中状态的头部字段名并不统一,需查阅对应文档,此处不做推测。

适用条件与待核实项#

以上讨论适用于可被共享缓存的 GET 类资源,且响应内容与请求者身份无关。对于个性化、写操作或实时性要求高的接口,主要问题不是缓存键,而是能否缓存——这需要单独判断。

关于 API.PLUS 平台自身的默认缓存键构成、边缘节点行为、缓存清除接口与配额,本次材料未提供,均待核实;在没有官方说明前,不宜按某一具体实现来设计键结构。

作者:沐小悠

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

更多文章 GET 示例接口

「」标签下的其他文章