首页
学习
活动
专区
圈层
工具
发布
社区首页 >专栏 >Cache-Control 到底怎么配:no-store、no-cache 和 max-age 的区别

Cache-Control 到底怎么配:no-store、no-cache 和 max-age 的区别

原创
作者头像
跨境出海观察员
发布于 2026-11-17 09:03:40
发布于 2026-11-17 09:03:40
50
举报

“改了代码,用户还是看到旧页面。”这类问题经常不是发布没生效,而是 Cache-Control 配错了。no-store、no-cache、max-age 看起来都是“不缓存”,实际行为差别很大。

一、三个容易混淆的指令

  • no-store:完全不存储,连缓存副本都不留;
  • no-cache:可以存储,但每次使用前必须向服务端验证;
  • max-age=0:缓存已过期,通常也会触发验证,但语义上仍允许缓存。

no-cache 不是“不缓存”,no-store 才是。很多“改了没生效”的问题,是因为把 HTML 设成了 max-age=3600,用户一小时内都拿不到新版本。

指令

行为

no-store

不存储

no-cache

存储但每次验证

max-age=0

立即过期,通常触发验证

must-revalidate

过期后必须验证,不能用过期副本

二、静态资源怎么配

带内容哈希的 JS/CSS 可以长缓存:

代码语言:http
复制
Cache-Control: public, max-age=31536000, immutable

文件名变了,URL 就变了,不存在“旧文件”问题;immutable 告诉浏览器在有效期内不要发验证请求,减少 304。

不带哈希的图片、字体,可以用较短缓存加验证:

代码语言:http
复制
Cache-Control: public, max-age=86400
ETag: "abc123"

HTML 入口页建议不缓存或短缓存:

代码语言:http
复制
Cache-Control: no-cache

这样用户每次打开都会验证一次,服务端返回 304 或新页面,不会卡在旧版本。Expires 是旧版字段,优先级低于 Cache-Control;新项目优先用 Cache-Control,不要两套混用。

三、CDN 与 private/public

public 允许 CDN 和浏览器缓存;private 只允许浏览器缓存,CDN 不应存储。带用户信息的接口如果误设 public,可能把 A 用户的响应发给 B 用户。

must-revalidate 适合支付、订单等强一致接口;过期后必须回源验证,不能继续用旧副本。stale-while-revalidate=60 则允许先返回过期副本、后台更新,适合非关键列表,不适合余额、库存。

s-maxage 专门控制 CDN 的缓存时间,优先级高于 max-age:

代码语言:http
复制
Cache-Control: public, max-age=60, s-maxage=600

这表示浏览器缓存 60 秒,CDN 缓存 600 秒。接口和页面要分别设置,不要一条规则套所有资源。

四、验证与 304

浏览器缓存过期后,会带 If-None-Match 或 If-Modified-Since 向服务端验证。服务端返回 304,浏览器继续用本地副本;返回 200,才下载新内容。

代码语言:http
复制
ETag: "v2-abc123"
Last-Modified: Tue, 17 Nov 2026 01:00:00 GMT

ETag 比 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 删除。

目录
  • 一、三个容易混淆的指令
  • 二、静态资源怎么配
  • 三、CDN 与 private/public
  • 四、验证与 304
  • 五、常见错误
  • 六、总结
问题归档专栏文章快讯文章归档关键词归档开发者手册归档开发者手册 Section 归档