Cloudflare Pages自定义域名部署后缓存未更新问题咨询

核心结论 #

Cloudflare Pages 部署新版本时，默认会自动清除 Pages 原生域名（如 xxxxxx-frontend-about.pages.dev）的缓存，但自定义域名的缓存不会自动触发全局清除——这就是你遇到自定义域名未更新的原因。

原因分析 #

• Pages 原生域名由 Cloudflare 直接管控，部署完成后会自动触发该域名下的缓存失效，确保用户能立即获取新版本内容。
• 自定义域名的缓存策略受你在 Cloudflare 仪表板中配置的缓存规则控制。如果没有设置与部署联动的缓存清除规则，旧缓存会继续保留，直到缓存自然过期（age: 6456 表示该缓存已存在约1小时47分钟）。

解决方法 #

• 手动清除自定义域名缓存：在 Cloudflare 仪表板的「缓存」→「配置」→「清除缓存」中，选择「清除单个文件」或「清除整个缓存」，输入自定义域名相关路径或直接清除整个域名缓存。
• 配置自动缓存清除规则：使用 Cloudflare API，在 Pages 部署完成后调用缓存清除接口，针对自定义域名触发缓存失效；也可在 Cloudflare 仪表板中为自定义域名设置「缓存规则」，将静态资源的缓存 TTL 设为较短时间，或配置基于部署触发的缓存失效逻辑。
• 验证缓存状态：部署后发送请求查看响应头中的 CF-Cache-Status，若显示 MISS 则表示已获取新内容，HIT 则说明仍命中旧缓存。

内容的提问来源于stack exchange，提问作者Vojtěch