
网站发布后,有的用户还是看到了老版本的内容和旧的交互方式,还会出现已经被修复过的错误信息——这通常不是因为部署出了问题,而是因为缓存链条没有及时更新。一次静态资源请求从浏览器发出之后,会经过内存缓存、磁盘缓存、CDN边缘节点、父级节点等几个环节才能到达对象存储或者源站。只要其中任何一个环节还存在旧的数据,那么用户得到的就是过时的信息。
解决这个问题的方法并不是“发布之后再去手动刷新”,而是在架构上把版本号融入到资源命名中。在构建的时候开启 contenthash,使 Webpack、Vite 等工具生成带有内容指纹的文件名:比如 app.8f3d2c.js,当内容发生变化时文件名也会随之改变,URL 就会变成一个全新的缓存键,浏览器和 CDN 都会把它当作新的资源来请求,从而自然地绕过旧的缓存。相应的策略就是分层设置 Cache-Control——带指纹的 JS/CSS/图片可以安全地设置为 public, max-age=31536000, immutable,这样浏览器一年内都不会再重新获取;而 index.html、版本清单以及配置文件等入口资源则必须设为 no-cache,以确保每次都进行源验证,防止入口缓存把旧的资源引用关系锁定住。
指纹策略可以覆盖大部分的情况,但是兜底刷新不能省略。发布流水线在上传资源、切换入口之后会自动调用CDN提供的刷新API(如阿里云RefreshObjectCaches、腾讯云PurgeUrlsCache、CloudflarePurge等),把入口HTML和没有经过指纹处理的兜底资源按照精确的URL提交失效任务,必要时还会触发预热使边缘节点主动回源。从粒度上看,URL刷新更精准一些,配额占用也较少,适合日常发布;而目录刷新则会连带子目录一起清空,在大版本更新的时候比较合适,但是会产生较大的回源压力,所以要避开业务高峰期进行。
在自动化流程中存在的几个常见的陷阱是:如果 CDN 开启了“忽略参数”的话,那么 ?v=1.2 这样的版本号就会被当作同一个缓存键来处理,从而导致版本控制失效;带有鉴权签名的 URL 必须使用原始 URL 来提交刷新请求,否则会出现任务显示为成功但是实际上没有命中到目标缓存的情况;Service Worker 有自己的缓存策略,需要用单独的 skipWaiting 和 controllerchange 逻辑来激活新版本;只更新边缘节点而不考虑父层(L2)缓存会导致“假的成功”;发布后的后处理阶段应该用 curl -I 来检查 X-Cache、Age、Cache-Control 这三个响应头,在多个地域节点上进行抽样对比以确认全局一致性之后再结束整个流程;对于资源404的比例、白屏率以及JS错误率等指标也要设定好阈值进行告警,一旦出现异常就会自动回滚到上一个版本。
发布之后用户无法获取到最新的版本,本质上就是缓存链路中某一层没有失效。工程上比较稳妥的做法是:用内容指纹来区分不同版本、入口HTML采用短缓存或者不缓存的方式、发布流水线自动调用CDN刷新接口并且进行多节点验证、再加上Service Worker主动更新和异常回滚等措施。把这些措施固定到CI/CD流程中去,那么缓存就会从“上线事故频发区”变成性能优化的工具了。