跳转到内容
本站为社区维护的非官方中文翻译,与 Cloudflare, Inc. 无关联。本站不提供账户登录,请勿在任何非官方站点输入您的 Cloudflare 账户信息。官方文档:developers.cloudflare.com

调查未缓存的响应

最后更新 查看 MarkdownAgent 设置

如果您期望被缓存的 URL 每次都从源站提供,cf-cache-status 响应标头可标识 Cloudflare 做出的缓存决定。获取该 URL,检查标头,并按照与您看到的值匹配的章节操作:

对于任何其他状态,请参阅缓存响应以获取完整列表。

开始之前

最近的清除所有内容、按 URL 清除、按前缀清除、按标签清除或按主机名清除会清空缓存。每个数据中心的下一次请求会重新填充缓存,并在后续请求返回 HIT 之前返回 MISS。如果最近执行过清除,请等待缓存重新填充后再继续。

DYNAMIC — 请求不符合缓存条件

Cloudflare 在查找缓存之前,于请求时做出了“不缓存”的决定。常见原因:

  • 文件扩展名不在默认缓存的文件扩展名列表中 — 例如 .html 或 JSON API 响应 — 并且没有规则为其启用缓存。添加将 Eligible for cache(符合缓存条件) 设置为 Yes(是) 的 Cache Rule。
  • 某条规则指示 Cloudflare 绕过缓存。 检查是否有设置为绕过缓存的 Cache Rule,或旧版 Cache Level: Bypass Configuration Rule 或 Page Rule 与该 URL 匹配。使用 Rules simulator 确认适用的规则。
  • 请求方法不是 GET 或 HEAD。 Cloudflare 仅缓存这两种方法。
  • zone 上启用了开发模式。 开发模式会暂停缓存三小时,并对每个响应返回 DYNAMIC。

一旦请求符合条件,后续响应会反映响应时的决定(HIT、MISS、BYPASS 等)。

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 Everything Page Rule 或将 Eligible for cache(符合缓存条件) 设置为 Yes(是) —— 且两者都没有显式 Edge TTL —— 的 Cache Rule 会覆盖此行为并返回 BYPASS。

    完整对照请参阅 Set-Cookie 响应标头与 Cache 的交互。

  • 源站返回了 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 — 可缓存但不在缓存中

每个数据中心的第一次请求出现 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 网络中跟踪请求所必需的。

相关资源

相关资源

这篇文档对您有帮助吗?