发版到 v1.4.2 用户还是旧文件 静态资源没哈希怎么查

1 月 9 日发版,前端把 app.js 换成新逻辑。第二天客服收到 17 条反馈,用户点按钮还是老的弹窗。开发机上刷新一次就正常,排查了两个小时才想到去看 Network 面板,app.js 的状态是 200 (from disk Cache),响应头里没有 Cache-Control,也没有 ETag。

nginx 那台机器上静态目录配置很简单,expires 30d,文件名固定叫 app.js、style.css。发版只是覆盖文件,URL 一个字节都没变。浏览器凭什么知道文件换了。运营商中间缓存更麻烦,刷新也不一定拉到新内容。

先确认问题范围。让三个同事分别用 Chrome 无痕窗口访问,其中一个在弱网下能看到新文件,另外两个还是旧的。抓包看响应头,缺 Last-Modified,说明中间层做过改写。拿 curl 直接打源站,返回的 app.js 已经是新内容,问题出在缓存链路,不是构建产物。

第一版改法是在 index.html 里给引用加 ?v=1.4.2。上线当天有效,第二次发版忘了改这个数字,旧问题原样回来。而且参数变了只是新 URL,旧文件仍然留在用户机器上,磁盘缓存一路涨。

后来改成构建时把内容哈希写进文件名,app.9f3c2a.js。index.html 设成 no-cache,静态目录设一年 immutable。发版后 index.html 每次回源,哈希文件名变了就自然拉新。回滚也简单,把旧的 index.html 换回去就行。

location /static/ {
    add_header Cache-Control "public, max-age=31536000, immutable";
}
location = /index.html {
    add_header Cache-Control "no-cache";
}

验证方法:DevTools 里勾掉 Disable cache,刷新一次拿到新哈希文件;再取消勾选,第二次请求应该是 200 (from disk cache),文件名不变才说明缓存按预期工作。线上抽查 20 个用户,只有 1 个还拿到旧文件,是公司出口的代理缓存,加上 Vary 并清掉缓存后恢复。

您可以还会对下面的文章感兴趣: