技术文章

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

HTTP 缓存与 CDN 加速实践:先定缓存键,再谈边缘加速

一句话回答

API 响应能否交给 CDN 加速,取决于三件事:响应是否允许共享缓存、用什么缓存键区分版本、失效靠 TTL 还是主动清除。本文按 HTTP 缓存标准语义梳理判定顺序、缓存键设计要点与排查步骤,并把具体 CDN 的默认 TTL、命中标志字段和清除传播时间列为待核实项。

API 响应能不能交给 CDN 加速,答案不在 CDN 的配置页上,而在这份响应是否允许被共享缓存保存、用什么键区分不同版本、失效靠 TTL 还是主动清除这三件事上。三者没定就接入 CDN,通常只是把错误的响应分发得更快。本文只讨论 HTTP 缓存语义层面的通用做法;各 CDN 的默认 TTL、命中标志字段名、主动清除的传播时间,本次没有可用材料,需要在目标厂商文档上核对。

第一层判定:响应允不允许被共享缓存#

CDN 的边缘节点属于共享缓存(shared cache),浏览器属于私有缓存(private cache)。两者遵循同一套 HTTP 缓存语义,但同一份响应在两处的结论可能不同。按 HTTP 缓存标准(IETF RFC 9111;本次写作未联网核验原文,落地前建议对照标准文本与所用 CDN 文档)几个关键点:

  • 带 Authorization 头的请求,共享缓存默认不能存储其响应,除非响应显式声明允许。
  • Cache-Control: private 表示只允许私有缓存保存;no-store 表示不得存储。
  • s-maxage 只对共享缓存生效,并覆盖 max-age,可用来把边缘 TTL 与浏览器 TTL 分开设置。

由此可知,“登录后接口”“带用户维度的响应”默认不适合进入共享缓存,除非把缓存键设计成与具体用户无关。这一步判断优先于任何加速配置。

缓存键:URL 之外还牵涉什么#

共享缓存通常以 URL 作为缓存键,同一个键命中边缘,不同键回源。对 API 而言,常出问题的是三处:查询参数、Vary、请求方法。

  • 查询参数:参数顺序不同、附带了不影响结果的噪声参数,都会产生不同的键,同一份内容被反复回源。可在回源前做参数规范化,或按业务需要忽略无关参数。
  • Vary:Vary: Accept-Encoding 很常见;若把完整 User-Agent 放进 Vary,键的数量会膨胀、命中率下降。Vary: * 则使响应不可缓存。
  • 方法:标准语义下适合被缓存的是 GET/HEAD 的响应;带副作用的请求不应指望缓存层代为应答。

常用缓存指令的作用范围可以对照下表。它是标准语义的归纳,具体 CDN 对个别指令的支持程度待核实。

指令主要作用对象含义
private共享缓存仅私有缓存可保存
public共享缓存显式允许共享缓存保存,包括原本默认不允许的情形
s-maxage共享缓存覆盖 max-age 与 Expires,仅共享缓存采纳
no-store全部不得存储响应
stale-while-revalidate全部过期后一段时间内先返回旧响应并在后台刷新

失效:短 TTL 还是主动清除#

两条路各有代价。短 TTL 实现简单、不依赖额外接口,代价是回源比例上升;主动清除(purge/invalidate)生效更快,但清除通常是异步的,边缘节点之间存在传播时间差,通配符清除往往更慢,一次误删还可能把流量瞬间压回源站。常见折中是:内容型响应用中等 TTL 搭配 stale-while-revalidate,用户相关响应以 no-store 挡在共享缓存之外,紧急变更走精确 URL 的清除。

排查顺序:先分层,再定位#

  1. 看响应头:Cache-Control、Age、ETag 或 Last-Modified 是否与源站预期一致。
  2. 判断命中的是哪一层:浏览器开发者工具显示的是私有缓存结果,CDN 的命中情况要看其自有标志字段(字段名与取值因厂商而异,待核实)。
  3. 区分“键不一致”与“已过期”:改动一个无关查询参数再请求,若两份都回源,先怀疑键设计;若只在时间间隔后回源,先怀疑 TTL。
  4. 确认中间层是否改写:源站发出的 Cache-Control 与到达客户端的值是否相同。

下面是一条观察响应头的占位命令,未实际执行,域名与路径均为演示值:

curl -sSI "https://example.com/api/v1/items?page=1"
# 占位示例,用于演示应观察的响应头,未运行

边界条件#

  • 带身份或权限差异的响应,不要放进共享缓存,除非缓存键已包含这些差异维度。
  • 请求方法的可缓存性、默认 TTL、清除接口的语义与传播时间,各 CDN 实现不同,属于需要逐项核实的部分。
  • 源站的 Cache-Control 未明确时,不要假设 CDN 会替你做出安全的选择。

作者:沐小悠

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

更多文章 GET 示例接口

「」标签下的其他文章