“改了代码,用户还是看到旧页面。”这类问题经常不是发布没生效,而是 Cache-Control 配错了。no-store、no-cache、max-age 看起来都是“不缓存”,实际行为差别很大。
no-store:完全不存储,连缓存副本都不留;no-cache:可以存储,但每次使用前必须向服务端验证;max-age=0:缓存已过期,通常也会触发验证,但语义上仍允许缓存。no-cache 不是“不缓存”,no-store 才是。很多“改了没生效”的问题,是因为把 HTML 设成了 max-age=3600,用户一小时内都拿不到新版本。
指令 | 行为 |
|---|---|
| 不存储 |
| 存储但每次验证 |
| 立即过期,通常触发验证 |
| 过期后必须验证,不能用过期副本 |
带内容哈希的 JS/CSS 可以长缓存:
Cache-Control: public, max-age=31536000, immutable文件名变了,URL 就变了,不存在“旧文件”问题;immutable 告诉浏览器在有效期内不要发验证请求,减少 304。
不带哈希的图片、字体,可以用较短缓存加验证:
Cache-Control: public, max-age=86400
ETag: "abc123"HTML 入口页建议不缓存或短缓存:
Cache-Control: no-cache这样用户每次打开都会验证一次,服务端返回 304 或新页面,不会卡在旧版本。Expires 是旧版字段,优先级低于 Cache-Control;新项目优先用 Cache-Control,不要两套混用。
public 允许 CDN 和浏览器缓存;private 只允许浏览器缓存,CDN 不应存储。带用户信息的接口如果误设 public,可能把 A 用户的响应发给 B 用户。
must-revalidate 适合支付、订单等强一致接口;过期后必须回源验证,不能继续用旧副本。stale-while-revalidate=60 则允许先返回过期副本、后台更新,适合非关键列表,不适合余额、库存。
s-maxage 专门控制 CDN 的缓存时间,优先级高于 max-age:
Cache-Control: public, max-age=60, s-maxage=600这表示浏览器缓存 60 秒,CDN 缓存 600 秒。接口和页面要分别设置,不要一条规则套所有资源。
浏览器缓存过期后,会带 If-None-Match 或 If-Modified-Since 向服务端验证。服务端返回 304,浏览器继续用本地副本;返回 200,才下载新内容。
ETag: "v2-abc123"
Last-Modified: Tue, 17 Nov 2026 01:00:00 GMTETag 比 Last-Modified 更精确,优先使用。两者都配时,If-None-Match 优先。CDN 通常按 TTL 缓存,改了源站不代表边缘立即更新;发布后需要刷新 URL 或等 TTL 到期。
第一,HTML 设了长 max-age,发布后用户看不到新版本。
第二,带哈希的静态资源设了 no-cache,每次都要验证,浪费请求。
第三,接口设了 public,CDN 缓存了用户相关数据。
第四,只改 max-age 不加 Vary,代理把 A 来源的 CORS 响应缓存给 B 来源。
第五,stale-while-revalidate 用过头,用户长时间看到旧数据;它适合可容忍短暂旧值的场景,不适合订单、支付等强一致接口。
Vary 也要配:Vary: Accept-Encoding 让缓存按压缩格式区分;Vary: Origin 让 CORS 响应按来源区分。漏配会把错误响应发给别人。
Cache-Control 的核心是“哪些资源可以长缓存、哪些必须验证”。带哈希的资源用长缓存 + immutable,HTML 用 no-cache,用户相关接口用 private 或 no-store。配置前先想清楚:这个资源变了,用户多久必须看到?如果源站和 CDN 都配了缓存,先确认是哪一层返回旧内容;DevTools 的 Size 列会显示 from disk cache、memory cache 还是 CDN。
原创声明:本文系作者授权腾讯云开发者社区发表,未经许可,不得转载。
如有侵权,请联系 cloudcommunity@tencent.com 删除。