如果您期望被缓存的 URL 每次都从源站提供,cf-cache-status 响应标头可标识 Cloudflare 做出的缓存决定。获取该 URL,检查标头,并按照与您看到的值匹配的章节操作:
DYNAMIC— Cloudflare 在查找缓存之前就认定该请求不符合缓存条件。请参阅 DYNAMIC — 请求不符合缓存条件。BYPASS— Cloudflare 已准备好缓存该响应,但源站响应或配置阻止了缓存。请参阅 BYPASS — 源站响应不可缓存。- 来自同一客户端的多次连续请求均为
MISS— 响应可缓存,但持续未命中缓存。请参阅 反复出现的 MISS — 可缓存但不在缓存中。
对于任何其他状态,请参阅缓存响应以获取完整列表。
最近的清除所有内容、按 URL 清除、按前缀清除、按标签清除或按主机名清除会清空缓存。每个数据中心的下一次请求会重新填充缓存,并在后续请求返回 HIT 之前返回 MISS。如果最近执行过清除,请等待缓存重新填充后再继续。
Cloudflare 在查找缓存之前,于请求时做出了“不缓存”的决定。常见原因:
- 文件扩展名不在默认缓存的文件扩展名列表中 — 例如
.html或 JSON API 响应 — 并且没有规则为其启用缓存。添加将 Eligible for cache(符合缓存条件) 设置为 Yes(是) 的 Cache Rule。 - 某条规则指示 Cloudflare 绕过缓存。 检查是否有设置为绕过缓存的 Cache Rule,或旧版
Cache Level: BypassConfiguration Rule 或 Page Rule 与该 URL 匹配。使用 Rules simulator 确认适用的规则。 - 请求方法不是
GET或HEAD。 Cloudflare 仅缓存这两种方法。 - zone 上启用了开发模式。 开发模式会暂停缓存三小时,并对每个响应返回
DYNAMIC。
一旦请求符合条件,后续响应会反映响应时的决定(HIT、MISS、BYPASS 等)。
请求符合缓存条件,但源站响应或配置阻止 Cloudflare 存储它。常见原因:
-
响应超过您方案的可缓存大小限制。 将对象拆分为更小的资源,或改用更高限制的方案。R2 是源站存储替代方案 —— 它不会提高 CDN 可缓存大小限制。
-
源站在
Cloudflare-CDN-Cache-Control或CDN-Cache-Control标头中返回了no-store或单独的private。 Cloudflare 会在Cache-Control之前评估这些标头,优先级为Cloudflare-CDN-Cache-Control>CDN-Cache-Control>Cache-Control。源站同时返回Cache-Control: public, max-age=3600和CDN-Cache-Control: no-store会产生BYPASS。Cloudflare 不会将Cloudflare-CDN-Cache-Control转发给客户端,因此它在响应中不可见 —— 如果您看到BYPASS且没有CDN-Cache-Control标头,请检查源站实际发送的内容,或让源站删除该标头后重新测试。带有忽略源站 cache-control 的 Edge Cache TTL 设置的 Cache Rule 会覆盖这两类指令。有关优先级规则,请参阅 CDN-Cache-Control。 -
Cloudflare-CDN-Cache-Control或CDN-Cache-Control中的no-cache、max-age=0或s-maxage=0不会产生BYPASS。 它们会在首次请求时产生MISS,随后在后续请求中产生REVALIDATED或EXPIRED。 -
源站返回了
Cache-Control: no-store或单独的private。 这些指令默认在任一 Origin Cache Control 模式下都会阻止缓存。有两个例外:带字段名的Cache-Control: private="<header>"仍然可缓存 —— Cloudflare 只删除被点名的标头。以及带有忽略源站 cache-control 的 Edge TTL 的 Cache Rule(Edge TTL → Ignore cache-control header and use this TTL 或 Status code TTL)会覆盖这两类指令,因此带有no-store加上该 Edge TTL 设置的响应会被缓存。 -
源站返回了
Cache-Control: no-cache、max-age=0或s-maxage=0,并且 Origin Cache Control 已禁用(Enterprise 方案的默认设置)。在启用 Origin Cache Control 时(Free、Pro 和 Business 方案的默认设置),这些指令会让 Cloudflare 缓存并重新验证响应,从而产生REVALIDATED或EXPIRED。请参阅了解no-store和no-cache指令以及 Conditions 表。 -
源站返回了
Set-Cookie标头。 默认情况下,Cloudflare 不会缓存包含Set-Cookie的响应。要缓存该响应,请使用以下方法之一:- 在 Cache Rule 上使用 Edge TTL → Ignore cache-control header and use this TTL 或 Status code TTL 设置显式 Edge TTL。Cloudflare 会忽略源站指令,剥离
Set-Cookie,并缓存该响应。 - 让源站返回
Cache-Control: private="Set-Cookie"或no-cache="Set-Cookie"。Cloudflare 会删除被点名的标头并缓存其余部分。 - 在缓存决定之前剥离
Set-Cookie,使用响应标头修改转换规则。 - 在禁用 Origin Cache Control 的 Enterprise 方案上,Cloudflare 会剥离
Set-Cookie并在默认缓存级别下缓存该响应。Cache Level: Cache EverythingPage Rule 或将 Eligible for cache(符合缓存条件) 设置为 Yes(是) —— 且两者都没有显式 Edge TTL —— 的 Cache Rule 会覆盖此行为并返回BYPASS。
完整对照请参阅
Set-Cookie响应标头与 Cache 的交互。 - 在 Cache Rule 上使用 Edge TTL → Ignore cache-control header and use this TTL 或 Status code TTL 设置显式 Edge TTL。Cloudflare 会忽略源站指令,剥离
-
源站返回了
Vary: *。 无论其他配置如何,此值始终会绕过缓存。 -
请求包含
Authorization标头,并且 Origin Cache Control 已启用(Free、Pro 和 Business 方案的默认设置)。在该模式下,只有当Cache-Control还包含public、s-maxage或must-revalidate时,响应才可缓存。在禁用 Origin Cache Control 的 Enterprise 方案上,Authorization本身不会阻止缓存。
如果启用了分层缓存,符合条件的请求可能在 Cloudflare 收到源站响应之前经过上层数据中心。产生 BYPASS 的源站标头在此次上层获取之后才生效,因此它们无法阻止该获取。要阻止请求到达上层,请使用请求时绕过规则 —— 带 Bypass cache(绕过缓存) 的 Cache Rule,或旧版 Cache Level: Bypass Configuration Rule 或 Page Rule。
有关此状态的参考定义,请参阅 BYPASS。
每个数据中心的第一次请求出现 MISS 是预期行为 —— 该请求会填充缓存。如果同一 URL 在连续请求中持续返回 MISS,则可能发生了以下情况之一。
默认情况下,Cloudflare 根据源站 scheme、主机、路径和查询字符串构建缓存键。在配置后,Cookie、标头和设备类型也可以参与。缓存键中的 scheme 是 Cloudflare 用于到达源站的 scheme,而不是客户端使用的 scheme —— 具有单一源站 scheme 的 zone 会从同一缓存条目为 HTTP 和 HTTPS 客户端请求提供内容。
如果每个真实客户端请求都产生不同的键,缓存就永远看不到重复请求,每次请求都是 MISS。常见模式:
- 每次请求都会变化的查询参数 — 会话 ID、时间戳或
utm_*等营销标签。默认情况下,每个唯一查询字符串都是单独的缓存条目。配置 Cache Rules 或缓存键设置,以排除或忽略每次请求都会变化的参数。排序只会规范化参数顺序 —— 仅当请求只是参数顺序不同而不是值不同时才使用它。 - 自定义缓存键包含每次用户都会变化的 Cookie 或标头。 创建自定义缓存键章节警告自定义键“可能会降低缓存命中率并导致缓存分片” —— 这就是同一行为。
- 按设备类型缓存对客户端的分类与预期不同,尤其是机器人或具有异常
User-Agent值的客户端。 - 为某个标头配置了 Cache Rules 中的 Vary,源站在其
Vary响应标头中列出了该标头,并且操作为normalize或passthrough。每个响应变体都存储在单独的键下。当标头基数较高时 —— 例如未规范化的Accept-Language值或每用户标头 —— 实际命中率会下降。bypass操作会完全阻止缓存。
两个完全相同的请求会生成相同的缓存键,因此无法显示差异。要进行诊断,请使用 Rules simulator 查看该 URL 应用的缓存键配置和 Vary 操作,然后将这些设置与实际客户端请求中不同的属性(查询字符串、Cookie、标头、设备类型)进行比较。
低流量资源可能在下一次请求到达之前被逐出缓存。如果来自同一数据中心对同一 URL 的两次连续请求都返回 MISS,请启用分层缓存或 Cache Reserve 以更长时间保留长尾内容。
如果您的请求到达不同的 Cloudflare 数据中心,每个数据中心都会产生自己的首次请求 MISS。比较数据中心代码 —— cf-ray 标头的最后三个字符 —— 以确认两个响应来自同一数据中心。不同的客户端网络仍可能到达同一数据中心,因此网络变化并不保证位置不同。
调整配置后,从同一客户端对该 URL 请求两次,并验证符合您配置的预期结果:
- 新鲜的正数 Edge TTL:
cf-cache-status: HIT,并且后续请求上的Age标头会增加。通过分层缓存从上层填充本地数据中心缓存的第一次请求上没有Age——HIT反映的是上层,但本地数据中心尚未从缓存提供它。后续请求会包含Age,并且在使用分层缓存时,该值可能已经很大,因为它反映对象在 Cloudflare 全网缓存中的年龄。 - 源站在启用 Origin Cache Control 时返回
Cache-Control: no-cache: 当源站确认缓存副本未更改时为cf-cache-status: REVALIDATED,当源站返回新内容时为EXPIRED。两者都表示响应已被缓存。单独的must-revalidate不会强制每次请求都重新验证 —— 它只阻止在新鲜 TTL 过期后提供过期内容。
如果在这些检查之后响应仍为 MISS 或 BYPASS,请捕获两个完整响应(请求和响应标头,包括 cf-ray 值)并提交支持工单。cf-ray 值是在 Cloudflare 网络中跟踪请求所必需的。
- 缓存响应 — 每个
cf-cache-status值的参考。 - 默认缓存行为 — Cloudflare 默认何时成功缓存。
- Cache Rules — 配置 Edge TTL、资格和缓存键。
- Cache Analytics — 衡量命中率并识别表现较差的 URL。