前端发版后 CDN 缓存不更新排查与最佳实践

张开发
2026/4/20 12:33:13 15 分钟阅读

分享文章

前端发版后 CDN 缓存不更新排查与最佳实践
前端发版后部分浏览器显示旧版本?一文搞定 CDN 缓存策略配置,彻底解决发版不生效问题。前言前端项目发版后,测试反馈"我这边看到的还是旧版本",但你本地刷新是新的。换个浏览器试,Safari 是新的,Chrome 是旧的。这种问题 90% 是 CDN 缓存导致的。本文以阿里云 CDN 为例,也适用于 AWS CloudFront、Azure CDN 等,原理相同。一、问题现象前端项目发版后,源站(OSS/Nginx)已更新部分浏览器访问到新版本,部分仍显示旧版本同一个 URL,不同地区/不同浏览器返回内容不一致强制刷新(Ctrl+Shift+R)后正常,但普通用户不会这样操作二、根因分析CDN 缓存机制用户请求 → CDN 边缘节点 ├── 缓存命中(HIT)→ 直接返回缓存内容(可能是旧的) └── 缓存未命中(MISS)→ 回源拉取最新内容 → 缓存 → 返回问题出在:index.html被 CDN 缓存了较长时间,发版后 CDN 节点仍返回旧的index.html。

更多文章