缓存头配错 用户看到三天前的页面:304 和 ETag 怎么配

运营改了活动页文案,刷新还是旧的,清缓存才看到。查响应头,HTML 上挂着 Cache-Control: max-age=604800,浏览器七天不回源。

这套头是当年为了扛流量统一加的。静态资源带 hash 确实该长缓存,HTML 跟着一起就出事,CDN 那边也缓存了七天,回源都省了。

先确认范围。curl -I 看首页响应头,Age 显示三天前,说明命中的是 CDN 边缘节点,不是浏览器本地缓存。浏览器和 CDN 的解法完全不同,这一条先分清楚。

改法是分开配。带 hash 的 /static/ 目录给 public, max-age=31536000, immutable;HTML 用 no-cache,允许缓存但每次带 ETag 回源校验,命中返回 304,传输只有一个响应头。

location ~* \.(js|css|woff2)$ {
  add_header Cache-Control "public, max-age=31536000, immutable";
}
location = /index.html {
  add_header Cache-Control "no-cache";
  etag on;
}

ETag 要注意集群。三台机器各自按 inode 生成,值不一致,用户轮询到不同机器就永远 200 全量返回。换成基于文件内容的强 ETag,或者只用 Last-Modified,二选一别混用。

还踩了一个:Nginx 的 expires 和 add_header 同时写,两个 Cache-Control 头都发出去,浏览器取第一个,配置看着改了实际没生效。curl -I 看一眼响应头就能发现。

CDN 侧的缓存键也要检查。默认带 query,活动页带 utm 参数,每个来源一个副本,命中率掉到 40%。配置忽略 utm 之后回到 92%。

版本号的思路也换了。以前靠 URL 加 ?v=20261109 手动改,漏改一次就是旧文件。现在构建时把 hash 写进文件名,HTML 引新路径,旧文件留着不删,回滚也方便。

现在 HTML 的 TTFB 因为有 304 反而低了 60ms。缓存不是越久越好,按文件类型分开定,HTML 永远留一条回源校验的路。

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