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 的清除。
排查顺序:先分层,再定位#
- 看响应头:
Cache-Control、Age、ETag或Last-Modified是否与源站预期一致。 - 判断命中的是哪一层:浏览器开发者工具显示的是私有缓存结果,CDN 的命中情况要看其自有标志字段(字段名与取值因厂商而异,待核实)。
- 区分“键不一致”与“已过期”:改动一个无关查询参数再请求,若两份都回源,先怀疑键设计;若只在时间间隔后回源,先怀疑 TTL。
- 确认中间层是否改写:源站发出的
Cache-Control与到达客户端的值是否相同。
下面是一条观察响应头的占位命令,未实际执行,域名与路径均为演示值:
curl -sSI "https://example.com/api/v1/items?page=1"
# 占位示例,用于演示应观察的响应头,未运行
边界条件#
- 带身份或权限差异的响应,不要放进共享缓存,除非缓存键已包含这些差异维度。
- 请求方法的可缓存性、默认 TTL、清除接口的语义与传播时间,各 CDN 实现不同,属于需要逐项核实的部分。
- 源站的
Cache-Control未明确时,不要假设 CDN 会替你做出安全的选择。