共计 3093 个字符,预计需要花费 8 分钟才能阅读完成。
缓存键出问题时,表现往往只有三句话:命中率莫名偏低、同一个 URL 有人拿到旧版本有人拿到新版本、配置改完旧内容还在。这三个现象指向的位置并不相同,按“先分清现象、再验证 Vary 头、然后查键的组成与规范化、最后核对修改后的残留”的顺序推进,比一上来就重写缓存规则更容易收敛。下面以 Cloudflare 的 Vary 行为与 CloudFront 的缓存策略/源站请求策略配合规则为据,说明每一步看什么、怎么验证、失败条件是什么。
第一步:把现象分成三类,避免走错方向
- 命中率低但内容正确:多半是缓存键被拆得过细,或源站响应把不该区分的请求头纳入版本选择。
- 同一 URL 返回错误版本:多半是版本选择取值与源站生成响应的依据不一致,或规范化把不同语义合并了。
- 配置修改后旧内容仍在:多半是旧缓存条目尚未过期且没有被清除,而不是新配置没生效。
这三类在后续步骤里查的对象不同:第一类查键的组成,第二类查 Vary 与规范化,第三类查清除与过期。先归好类,再去抓响应头。
第二步:确认源站响应到底带没带 Vary
Cloudflare 文档明确:只有当源站响应包含 Vary 头时,列出的请求头才会成为该响应的缓存键组成部分;如果源站响应没有 Vary 头,Cloudflare 按常规方式缓存。Cloudflare Vary 文档还说明,仅仅在 Cache Rules 中配置 Vary 并不会让每个缓存响应都按 Vary 区分,实际是否生效仍取决于源站响应。同一文档
因此,一种可尝试的验证思路是绕过 CDN 直连源站,抓取目标 URL 的响应头,确认是否存在形如下面的 Vary(此为基于文档规则的推断性排查建议,非文档给出的验证流程)。以下为示意响应,非实测:
Vary: Accept-Language
Cache-Control: public, max-age=3600
成功判据:源站响应确实列出你期望区分的头;若没有,后续在 CDN 侧调 Vary 动作都不会改变版本选择。另一失败条件:Vary 头列出的名字在 CDN 配置中对应 bypass,那么该响应不会被缓存,表现为持续回源而不是版本串用。↗
第三步:核对每个 Vary 头的动作是 normalize、passthrough 还是 bypass
Cloudflare 为每个配置的头提供三种动作,含义与适用场景如下(据 Cloudflare Vary 文档):
| 动作 | 含义 | 适用 |
|---|---|---|
normalize |
选择缓存版本前先规范化请求头值,部分头还会把规范化值转发给源站↗ | 多数 Accept、Accept-Language、Accept-Encoding 场景 |
passthrough |
用原始请求头值选择版本,头原样转发↗ | 需要按字节区分头值差异时 |
bypass |
该头名出现在源站 Vary 响应时不缓存↗ | 取值过多、按用户区分、不希望缓存的头 |
验证方法是构造两个语义相同、字节不同的请求头(例如顺序不同的 Accept),分别请求同一 URL,观察是否落到不同版本:
Accept: text/html, application/json
Accept: application/json, text/html
按文档,在 passthrough 下这两个请求会选中不同缓存版本;而 normalize 会转换等价取值以合并版本,从而减少缓存版本数量。Cloudflare Vary 文档
这里有一个容易误判的点:normalize 可能是“有损”的,它会重排取值、去掉质量值、转为小写、删除不在允许列表中的条目。文档给的例子是 Accept-Language: en-US, fr;q=0.8 与 Accept-Language: fr;q=0.8, en-GB 规范化后都成为 en,fr,共享同一缓存版本;而 Accept-Language: fr, en;q=0.8 规范化值不同,会选中另一版本。若你的源站依赖原始取值生成内容,normalize 就可能把本该区分的内容合并,这时应改查是否该用 passthrough。Cloudflare Vary 文档
对于 Accept、Accept-Language、Accept-Encoding,当启用 Respect Strong ETags 时,Cloudflare 还可能把规范化后的值转发给源站;这种改写依据的是 Cache Rule 配置,即使源站最终响应没有列出该头,请求头仍可能被改写。所以排查“源站看到的头与客户端发的头不一致”时,要同时看配置与 ETag 相关开关,而不是只怀疑源站。↗
第四步:查缓存键里是否混进了不该有的维度
若现象是命中率低,重点看键被拆了多少份。Cloudflare 默认以 URL 加少量特定请求头构造缓存键,Cache Rules 可提前把其他请求属性加入键。把用户相关、取值空间大的头放进键,或在多个头上同时生效 Vary,都会让同一 URL 分裂成大量版本。↗
CloudFront 侧要分清算策略和源站请求策略:缓存策略决定缓存键,源站请求策略决定额外转发什么给源站。文档明确,缓存键中指定的所有查询串、HTTP 头和 Cookie 会自动进入源站请求;源站请求策略再追加的值只进入源站请求、不进入缓存键。CloudFront 文档也就是说,源站请求策略无法把已在缓存键中的维度删掉,只能加。
文档还给出两份策略“看似冲突”时的取值规则,可用表格定位(据同一 CloudFront 文档):
| 缓存策略 | 源站请求策略 | 进入源站请求的值 |
|---|---|---|
| None | None | 不含查看器请求中的值,仅默认值↗ |
| All | Block list | 全部查询串与 Cookie 都进入,即使列在阻止列表中;缓存策略设置覆盖阻止列表↗ |
| Allow list | Block list | 缓存策略允许列表中的值进入,覆盖阻止列表↗ |
| Block list | Allow list | 源站请求策略允许列表中的值进入,覆盖缓存策略阻止列表↗ |
另需注意,CloudFront 缓存策略不能指定全部头,也不能用头的阻止列表。若现象是“源站看到的头比预期多”,先确认是缓存键带进去的还是源站请求策略追加的,两者处理方式不同。↗
第五步:修改配置后验证残留,必要时主动清除
Cloudflare 文档说明,清除一个 URL 会清除该 URL 的所有缓存版本,不需要为每个 Vary 取值分别清除,按 URL、标签、主机名、前缀等方式清除都适用;同时,修改 Vary 配置本身不会清除已缓存内容,新配置下请求可能未命中并回源,直到旧条目过期或被清除。Cloudflare Vary 文档
验证顺序建议:
- 先只读核查:对比修改前后同一 URL 的响应头与版本表现,记录旧条目仍命中的请求头取值。
- 再主动清除目标 URL(或按标签、前缀范围清除),不要依赖修改配置自动生效。
- 清除后重放第三步的两组对照请求,确认版本选择与新配置一致。
- 若仍不一致,回到第二步确认源站 Vary 是否真的变了,而不是继续调 CDN 动作。
失败条件要记清:清除只解决旧条目残留,不修复键设计错误;若清除后命中率依旧偏低,说明问题在键被拆得过细,应回到第四步而不是反复清除。
验证方法的边界
本文的规则来自上述两份厂商文档,没有在真实站点上执行过对照请求,因此文中所有响应头与请求示例都只是说明性示意,需要替换为你的实际域名与头取值(示例中用到的 URL 与取值均为占位)。此外,文中“先对同一 URL 用不同候选请求头请求、再与源站直连结果对照”的排查思路属于基于文档规则的推断性建议,并非文档给出的验证流程,执行时需结合你的实际环境判断。文档覆盖的是 Cloudflare 的 Vary 与 CloudFront 的策略配合机制;其他 CDN 的 Vary 支持程度和规范化规则未在本次材料中涉及,不能据此直接套用。若排查中发现响应头与策略配置都符合文档描述却仍异常,需要补充该 CDN 的具体版本或功能开关资料再判断。↗
常见问题
源站已经返回 Vary: Accept-Language,为什么 Cloudflare 仍只缓存一个版本?
需要确认该头的动作配置与源站响应是否一致。按 Cloudflare 文档,配置的动作决定哪个请求头值被加入缓存键:normalize 用规范化值,passthrough 用原始值;若配置为 bypass,则该响应不会被缓存。另外 Cache Rules 中配置 Vary 只是准备,实际生效取决于源站响应是否带 Vary 头。
为什么修改 Vary 配置后,用户仍拿到旧内容?
Cloudflare 文档说明,修改 Vary 配置本身不会清除缓存内容;新配置可能改变缓存版本的选择方式,请求会在新键下未命中并回源,旧条目在过期或被清除前仍可能被使用。
CloudFront 的源站请求策略能不能把缓存键里的头去掉?
不能。按 CloudFront 文档,缓存策略中指定的查询串、头、Cookie 一定进入源站请求;源站请求策略只能追加额外的值。当两份策略看似冲突时,例如缓存策略允许列表与源站请求策略阻止列表冲突,缓存策略的允许列表会覆盖阻止列表。
怎样区分缓存键设计问题和源站本身返回错误?
一种思路是先对同一 URL 用不同的候选请求头分别请求,观察返回内容是否随头变化,再核对源站直连时的相同请求。缓存键问题的特征是同一 URL 因请求头取值不同而落到不同缓存版本或反复未命中;若直连源站也返回相同错误,则应先查源站,而不是继续调缓存键。此对照方法为基于文档规则的推断性建议,并非文档给出的验证流程。
引用资料
资料链接仅表示正文使用了该素材,不代表所有结论已独立核验。