Cloudflare 边缘缓存静默失效与 520 排障
明明在 Cloudflare 面板配置了“HTML 边缘缓存 24 小时、静态资源 7 天”,为什么全球节点实测返回头依然全部是 cf-cache-status: DYNAMIC,且跨洲回源偶发 HTTP 520?本文记录这次边缘缓存静默旁路的完整排查链条。
一、故障表象:跨洲节点首字节 14 秒与偶发 520
在主站完成纯静态化改造后,直连源站(洛杉矶机房)响应稳定在 0.9s,但从南亚/东南亚经 Cloudflare 孟买(BOM)边缘节点访问时,首字节时间(TTFB)在 1–14s 之间剧烈抖动,且约 10% 的请求直接返回 Cloudflare HTTP 520。排查源站 Nginx access.log 与 error.log 发现:返回 520 的请求根本没有到达源站 Nginx,故障发生在边缘节点到源站的跨洲公网回源握手上。
二、顺藤摸瓜:为什么每一次请求都在穿透回源
既然是纯静态网站,为什么边缘节点每次都要跨洲回源?我们拉取响应头检查,惊讶地发现不仅是 HTML,连 .css 与 .png 的 cf-cache-status 全都是 DYNAMIC——整站的边缘缓存规则从始至终没有生效过。
通过 Cloudflare API 导出全量 Rulesets 逐条比对(phases/http_request_origin/entrypoint 与 http_request_cache_settings),终于定位到罪魁祸首:
- 历史遗留的 Origin Rule(回源端口改写):早期因源站 443 端口由其他服务监听,曾在 Cloudflare 配了一条 Origin Rule 将回源端口改写至非标端口
8443。 - 隐性缓存旁路机制:在当时的规则组合下,带有非标端口改写的请求未命中默认缓存条件,导致边缘节点将全站请求视为动态回源流量处理。
- 处置与实测验证:在源站切回标准 443 监听并停用该条 Origin Rule 后,边缘缓存立即生效,
cf-cache-status稳定转为HIT,全球边缘节点首字节响应时间直接从数秒骤降至0.12s。
三、24 小时边缘缓存下的原子发布与按 URL 批量 Purge
开启 HTML 边缘缓存 24 小时后,带来了第二个工程命题:如果只用 rsync 上传新 HTML 而不清缓存,访客和搜索引擎爬虫在接下来一整天内拿到的仍是旧页面,且没有任何报错提示。
为此我们在 tools/deploy-site.sh 中将“缓存清理”固化为发布的强制步骤:
- 拒绝粗暴的
purge_everything:同一主域 Zone 下可能挂载其他独立业务子域,全量清缓存会造成跨服务误伤。 - 动态解析
sitemap.xml分批原子 Purge:发布脚本自动提取CORE_PAGES与sitemap.xml中的全部 URL,按 Cloudflare API 单次上限(≤30 个 URL/批)分批精准清除边缘缓存,并在清理后自动遍历核心入口预热核验HTTP 200。
关联工程母题系统与实测说明:
本篇「Cloudflare 边缘缓存静默失效与 520 排障」由 qilai 整理收录于 qilaidav 工程知识库,围绕 SEO 深度诊断与 Topical Authority 体系 的生产环境架构设计、链路排障与确定性验证展开沉淀。完整系统模块、部署边界与技术规格请查阅方案主页:→ 查看 SEO 深度诊断与 Topical Authority 体系 详情(架构诊断与定制交流:Telegram @BD8888 · hello@qilaidav.com · GitHub @qilaidev)。
免责声明与评测方法:本文所涉开源工具、模型基准与工程配置均基于实测环境与公开技术资料整理,仅供系统架构研发参考,不构成任何商业背书或投资建议。
— qilai · qilaidav 生产环境一手排障实录