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

Cloudflare 缓存响应

最后更新 查看 MarkdownAgent 设置

CF-Cache-Status 标头输出指示资源是否已缓存。要调查此标头返回的缓存响应,请使用 Redbot ↗、webpagetest.org ↗ 或 Cloudflare Optics 插件 ↗等可视化工具。

以下是对 Cloudflare 缓存响应状态的全面说明。

HIT

在 Cloudflare 缓存中找到资源。

MISS

响应符合缓存条件,但在请求时不在 Cloudflare 缓存中,因此从源站 Web 服务器提供。Cloudflare 选择不缓存的响应会返回 BYPASS 而非 MISS。

NONE/UNKNOWN

Cloudflare 生成了表示资源不符合缓存条件的响应。这可能是因为:

  • Worker 生成响应而未发送任何子请求。在这种情况下,响应不是来自缓存,因此缓存状态为 none/unknown。

  • Worker 请求发出子请求(fetch)。在这种情况下,子请求会记录缓存状态,而主请求记录为 none/unknown 状态(主请求未命中缓存,因为 Workers 位于 cache 之前)。

  • WAF 自定义规则被触发以阻止请求。响应来自 Cloudflare 全球网络,在到达 cache 之前。由于没有缓存状态,Cloudflare 记录为 none/unknown。

  • 重定向规则或 Always Use HTTPS 导致全球网络响应重定向到另一个资源/URL。此重定向响应在请求到达 cache 之前发生,因此缓存状态为 none/unknown。

EXPIRED

在 Cloudflare 缓存中找到资源但已过期,从源站 Web 服务器提供。

STALE

从 Cloudflare 缓存提供资源但已过期。Cloudflare 无法联系源站 Web 服务器获取更新的资源。

BYPASS

Cloudflare 在请求时认为资源符合缓存条件——要么因为它匹配默认缓存的文件扩展名,要么因为 Cache Rule 为其启用了缓存——但源站响应最终不可缓存。

源站响应被视为不可缓存的常见原因包括:

  • 响应超过您方案的最大可缓存文件大小。
  • 源站在 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。带有忽略源站 cache-control 的 Edge Cache TTL 设置的 Cache Rule 会覆盖这些指令,效果与覆盖 Cache-Control: no-store 相同。这些标头中的 no-cache、max-age=0 或 s-maxage=0 不会产生 BYPASS。它们会在首次请求时产生 MISS,随后产生 REVALIDATED 或 EXPIRED。有关优先级规则,请参阅 CDN-Cache-Control。
  • 源站返回了 Cache-Control: no-store 或 private。这些指令在任一 Origin Cache Control 模式下都会阻止缓存。
  • 源站返回了 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 标头。有关会产生 BYPASS 的具体配置,请参阅 Set-Cookie 响应标头与 Cache 的交互。
  • 源站返回了 Vary: * 响应标头,这始终会绕过缓存。
  • 请求包含 Authorization 标头,并且 Origin Cache Control 已启用(Free、Pro 和 Business 方案的默认设置)。在该模式下,只有当 Cache-Control 还包含 public、s-maxage 或 must-revalidate 时,响应才可缓存。在禁用 Origin Cache Control 的 Enterprise 方案上,Authorization 本身不会阻止缓存。

BYPASS 表示不缓存的决定是在响应时 做出的——请求最初符合缓存条件,但源站响应或响应标头指示 Cloudflare 不要缓存。例如,设置 "cache": true 的 Cache Rule 在请求时启用缓存,但如果源站返回 Cache-Control: no-store,响应将为 BYPASS。

如果您期望某个 URL 被缓存,但看到的是 BYPASS,请参阅调查未缓存的响应以获取逐步诊断。

REVALIDATED

源站通过条件请求(If-Modified-Since 或 If-None-Match)确认缓存资源未更改,响应从 Cloudflare 缓存提供。此状态反映同步验证路径——请求在提供之前等待源站响应。

使用异步 stale-while-revalidate 时,大多数重新验证现在返回 UPDATING 或 HIT。在以下情况下会看到 REVALIDATED:未设置 stale-while-revalidate;或 must-revalidate 或 no-cache(启用 Origin Cache Control 时)等指令阻止提供 stale 内容。

UPDATING

资源已过期但从 Cloudflare 缓存提供,同时源站在后台更新它。UPDATING 是异步 stale-while-revalidate 重新验证期间的预期状态——重新验证窗口内的所有请求接收 UPDATING 或 HIT,而非等待源站。

DYNAMIC

Cloudflare 在请求时确定资源不符合缓存条件,因此请求直接前往源站 Web 服务器,未进行缓存查找。

这通常发生在:

使用 Cache Rules 更改 Cloudflare 缓存的内容。一旦请求被视为符合缓存条件,CF-Cache-Status 标头将反映响应时的缓存决定(HIT、MISS、EXPIRED、REVALIDATED、BYPASS 等)——有关源站响应最终不可缓存的情况,请参阅 BYPASS。

如果您期望请求符合缓存条件,但看到的是 DYNAMIC,请参阅调查未缓存的响应。

这篇文档对您有帮助吗?