Cache-Control 响应头告诉浏览器和 CDN:能不能留一份副本、副本多久内算新鲜、过期后怎么办。HTML 用 no-cache,文件名带哈希的静态文件用 max-age=31536000, immutable,个人页面用 private 或 no-store,别把这个选择交给缓存去猜。
读完你会知道
- 新鲜的副本直接复用、不发请求,过期的要重新验证。没有 Cache-Control 时缓存会猜(RFC 9111 建议取距 Last-Modified 时间的 10%)
- 取值要和地址匹配:带哈希的文件用 max-age=31536000, immutable,HTML 用 no-cache,个人页面用 private 或 no-store
- no-cache 不等于不存储。示例里所有文件都用 no-cache 时每次访问 17 个请求,推荐配置只要 1 个,少了 94%
Cache-Control 响应头决定什么
服务器返回的每个响应都可以带一个 Cache-Control 头。它告诉浏览器和 CDN 这类共享缓存三件事:能不能留一份副本,这份副本在多长时间内算新鲜,过期之后该怎么办。副本还新鲜时直接复用,完全不发网络请求;过期了,要么向服务器做一次条件请求(通常返回很短的 304 Not Modified),要么直接丢掉。
如果完全不发 Cache-Control,缓存可以自己猜。RFC 9111(2022 年 6 月,4.2.2 节)写明:缓存看到 Last-Modified 日期时,可以按「距该日期过去的时间」的一个比例设定启发式有效期,并给出 10% 作为典型比例。MDN 对这种情况的建议很直接:只要你对缓存有要求,就在响应头里明确写出来。这个头的全部作用就是:对每一类文件用一个明确的决定代替猜测。
真正用得到的几个指令
指令有十几个,八个就能覆盖绝大多数网站。下面的定义依据 MDN 的 Cache-Control 参考页。
| 指令 | 含义 | 典型用途 |
|---|---|---|
max-age=N | 响应在生成后的 N 秒内保持新鲜 | 任何可以不再询问就直接提供的文件 |
s-maxage=N | 同上,但只对 CDN 这类共享缓存生效;在共享缓存里覆盖 max-age,私有缓存会忽略它 | 让 CDN 比浏览器多留一会儿页面 |
no-cache | 响应可以被存储,但每次复用前必须向源站验证 | HTML 和其他地址不变、内容会变的文件 |
no-store | 任何缓存(私有或共享)都不应存储这个响应 | 账户页、收据、任何敏感内容 |
must-revalidate | 一旦过期,复用前必须验证 | 过期副本会出错时,和 max-age 配合 |
immutable | 响应在新鲜期内不会变化 | 地址里带版本号或内容哈希的文件 |
public / private | 共享缓存可以存储 / 只有浏览器自己的缓存可以存储 | 与单个用户相关的内容用 private |
stale-while-revalidate=N | 过期后的 N 秒内可以继续使用旧副本,同时在后台取新的 | 稍微旧一点也无所谓的内容 |
有两个细节能省下很多排查时间。其一,max-age 从响应生成时开始算,不是从浏览器收到时开始,所以在 CDN 里待了 40 秒的响应只剩下少了 40 秒的有效期,Age 头报告的就是这段时间。其二,MDN 的参考页没有给 max-age 定义上限,但 web.dev 的 HTTP 缓存指南称 31,536,000 秒(一年)是支持的最大值,所以用这个值就够了。
按文件类型该设什么
取值取决于一个问题:这个地址的内容会不会变?如果地址本身带版本,内容可以缓存一年;如果地址不变而内容会变,浏览器就必须去问。下表是起点,属于经验判断而不是标准,发布流程不同的地方请自己调整。
| 文件类型 | 地址会随内容变化吗 | 建议的 Cache-Control | 原因 |
|---|---|---|---|
| HTML 页面 | 不会(/pricing 永远是 /pricing) | no-cache,并带 ETag | 每次都检查,新版本立刻生效;一次 304 只有几百字节 |
带内容哈希的 CSS 和 JS(app.3f9a1c.js) | 会 | public, max-age=31536000, immutable | 新构建产生新地址,旧地址不需要过期 |
| 字体(带哈希或版本) | 会 | public, max-age=31536000, immutable | 字体几乎不变,而且下载代价高 |
| 文件名带哈希的图片 | 会 | public, max-age=31536000, immutable | 理由和脚本相同 |
| 地址里没有版本的图片、CSS 或 JS | 不会 | max-age=86400(一天)或 no-cache | 较短的有效期限制了过期副本能存活多久 |
| 所有用户共用的接口响应 | 不会 | public, max-age=60 或 s-maxage=60, stale-while-revalidate=30 | 重复请求便宜,旧一分钟没问题 |
| 单个登录用户的接口响应或页面 | 不会 | private, no-cache(敏感内容用 no-store) | 不让某个人的数据进入共享缓存 |
| 支付、账户或健康类页面 | 不会 | no-store | 不应写入任何缓存 |
web.dev 的指南给出的也是两个极端:带指纹或版本的地址用 max-age=31536000,需要每次使用前重新验证的资源用 no-cache,并用 ETag 让验证变得便宜。表中其余各行都介于这两端之间。
| 文件类型 | 建议的 Cache-Control | 原因 |
|---|---|---|
| HTML 页面 | no-cache,并带 ETag | 每次都检查,新版本立刻生效 |
| 带哈希的 CSS、JS、字体、图片 | public, max-age=31536000, immutable | 新构建产生新地址,旧地址不需要过期 |
| 地址里没有版本的图片、CSS、JS | max-age=86400,或 no-cache | 较短的有效期限制过期副本的存活时间 |
| 所有用户共用的接口响应 | public, max-age=60 | 重复请求便宜,旧一分钟没问题 |
| 单个用户的页面或接口 | private, no-cache | 不让个人数据进入共享缓存 |
| 支付、账户、健康类页面 | no-store | 不写入任何缓存 |
依据 MDN 和 web.dev 的指导给出的起点,不是标准。请按你自己的发布流程调整。
算例:回访一次要付出什么
示例数据:一个页面由 1 个 HTML 文档(30 KB)、1 个样式表(80 KB)、1 个脚本(250 KB)、2 个字体(共 60 KB)和 12 张图片(600 KB)组成,首次访问是 17 个请求、1,020 KB。假设一次 304 响应的头部约 0.4 KB,HTML 自上次访问后已经更新,静态文件的最后修改时间是 30 天前。比较三种配置下的回访:
- A. 没有
Cache-Control。 启发式有效期是 30 天的 10%,即 72 小时。 - B. 全部文件都是
no-cache。 每次访问都重新检查每个文件。 - C. 带哈希的静态文件用
max-age=31536000, immutable;HTML 用no-cache。
| 回访时间 | A:没有响应头 | B:全部 no-cache | C:推荐配置 |
|---|---|---|---|
| 1 天后 | 1 个请求,30 KB | 17 个请求,36.4 KB | 1 个请求,30 KB |
| 5 天后 | 17 个请求,36.4 KB | 17 个请求,36.4 KB | 1 个请求,30 KB |
| 8 天后 | 17 个请求,36.4 KB | 17 个请求,36.4 KB | 1 个请求,30 KB |
计算过程:配置 B 要发 1 次完整 HTML(30 KB)加 16 次条件请求(16 × 0.4 KB = 6.4 KB),共 17 个请求、36.4 KB。配置 A 在前 72 小时的表现和 C 一样,到第 5 天因为猜测的有效期已过而一下子退化;如果文件是两天前修改的,这个猜测只能维持 4.8 小时。配置 C 每次回访只需 1 个请求,相对 B 以及第 3 天之后的 A 少了 16 个请求(94%)。字节数看起来差得不多,是因为 304 本身很小;B 的真正代价是多出的 16 次往返,每一次都可能让慢网络卡住渲染。首次访问在三种配置下都是 1,020 KB,所以缓存对第一次加载没有帮助,它帮的是之后的每一次。
回访时的请求数(5 天后)
示例页面,17 个请求为什么 no-cache 不等于「不缓存」
最常见的错误是把 no-cache 读成「不要存」。MDN 说得很清楚:no-cache 不是「不缓存」。响应可以被存储,但每次复用前必须向源站验证。RFC 9111(5.2.2.4 节)描述的行为一致:已存储的响应在没有先转发请求做验证的情况下不能使用。真正禁止存储的指令是 no-store(5.2.2.5 节)。
这在两个方向上都有影响。给带哈希的 JavaScript 文件加 no-cache,你每次访问都要付 16 次验证往返,就像上面的配置 B。给含个人数据的页面加 no-cache 并以为它不会被存下来,则是依赖了一个允许存储的指令。这类页面请用 no-store,前面有 CDN 时再加上 private。
长有效期只有在地址会变时才安全
表里一年的 max-age 有个前提:每次发布必须产生新地址。构建工具的做法是在文件名里放内容哈希,代码一变,app.3f9a1c.js 就成了 app.b72e04.js。每次都会重新验证的 HTML 指向新文件名,旧文件自然不再被请求。
做不到这一点,长有效期就是陷阱。给 /styles.css 设 max-age=31536000,意味着回访用户可以保留旧样式表长达一年,而你无法召回。先把地址固定下来,再拉长有效期。
immutable 还有一个好处。RFC 8246(2017 年 9 月)解释说,普通刷新时浏览器会对子资源发条件请求,即使网站是靠更换地址来更新的,这些请求也只会返回 304。带上 immutable,客户端在响应新鲜期内应当跳过它们,只有用户明确的强制刷新才会覆盖。
共享缓存和个人数据
CDN 是共享缓存,所以会遵守 s-maxage、public 和 private。三条规则能避开大部分麻烦。
- 与单个用户相关的内容用
private。 标了private的响应只能存在浏览器自己的缓存里。 - 用
s-maxage给 CDN 一个与浏览器不同的有效期。 对每小时更新一次的博客列表页,max-age=0, s-maxage=3600让 CDN 扛住流量,而浏览器每次都重新检查。 - 稍旧一点也能接受时用
stale-while-revalidate。 MDN 的例子是max-age=604800, stale-while-revalidate=86400:7 天内新鲜,之后再多一天可以复用旧副本,同时在后台取新的。
还要留意那些悄悄关掉缓存的响应头。Cloudflare 的默认缓存行为页面把 private、no-store、no-cache、max-age=0 和 Set-Cookie 头列为响应不会在其边缘节点缓存的原因。其他 CDN 有各自的规则,所以请用下一节的命令测试你的环境。
怎样查看服务器实际发了什么
除了浏览器,不需要别的工具。
- 命令行。 运行
curl -sI https://example.com/assets/app.3f9a1c.js,读cache-control那一行;HTML 页面也做一遍。再加上-H "If-None-Match: <etag>"重复一次,确认重新验证返回304。 - 浏览器开发者工具。 打开 Network 面板,刷新两次,看 Size 列。显示
(memory cache)或(disk cache)表示没有发请求;几百字节且状态为304表示发生了一次重新验证。 - 找出缺失的响应头。 没有
Cache-Control的文件都靠猜测在缓存。按文件类型列出来,给上表里的每一行指定一条规则。 - 发布后检查响应。 确认 HTML 指向新文件名,并且旧的带哈希文件仍能提供给持有缓存页面的访客。
怎样在 TapCub 里看到效果
接着上面的例子。你上线配置 C 之后,需要的是真实访客加载更快的证据,而不只是响应头看起来对了。TapCub 不设置也不读取你的响应头,它衡量的是访客的实际体验。

- 标出变更。 在 配置 › 日期标注 里为发布日期加一条标注,图表上就会显示这个日期。
- 打开真实用户数据。 在 监测 › 性能 里看最大内容绘制和首字节时间两张卡片。TapCub 把 LCP 在 2.5 秒以内评为良好、超过 4 秒为差,把 TTFB 在 800 毫秒以内评为良好、超过 1.8 秒为差。把卡片切到 P75,因为缓存帮助的正是较慢的那批访客。
- 对比相同长度的时间段。 性能页面没有上一周期对比,所以先把日期范围设为变更前两周,记下 P75 的数值,再对变更后两周重复一次。
- 找出没有改善的页面。 最慢页面 列表按 P75 的 LCP 排序;一直留在列表里的页面,多半是没缓存的 HTML 或没设长有效期的图片。
这些数字来自访客的浏览器,所以包含回访用户,也就是缓存影响最大的那批人。TapCub 负责报告结果,响应头本身要在你的网络服务器或 CDN 里设置。
常见问题
静态文件的 Cache-Control 该设成什么?
文件名里带版本或内容哈希的文件,用 public, max-age=31536000, immutable。一年是 web.dev 列出的最大值,immutable 能让浏览器刷新时不再重新检查。文件名固定的静态文件,用较短的有效期,例如 max-age=86400,或者 no-cache 加 ETag。
no-cache 和 no-store 有什么区别?
no-cache 允许缓存存储响应,但每次复用前要向源站验证。no-store 告诉所有缓存(私有或共享)完全不要存储响应。经常变化的 HTML 用 no-cache,绝不能写入磁盘的页面,比如账户或支付页,用 no-store。
max-age=0 起什么作用?
它让响应立即过期,所以缓存复用前必须先向源站确认。副本过期会出错时,把它和 must-revalidate 配合。有些 CDN 对这种响应根本不缓存:Cloudflare 的文档把 max-age=0 列在默认会停止边缘缓存的取值里。依赖它之前,先确认你的 CDN 怎么处理。
Cache-Control 是服务器设置还是浏览器设置?
由服务器写在响应里,浏览器照着执行。浏览器自己也会在请求里发 Cache-Control,比如刷新时的 max-age=0,但决定副本保持多久新鲜的是响应头。请在网络服务器、应用框架或 CDN 里配置。
还需要 Expires 或 Last-Modified 吗?
有 Cache-Control: max-age 时不需要 Expires,因为 max-age 优先。ETag 或 Last-Modified 要保留:它们让服务器可以回答 304 Not Modified 而不用重新发送文件,使重新验证变得便宜。
资料来源
- MDN Web Docs,Cache-Control 响应头参考。指令定义和示例。2026-11-20 核对。
- web.dev,Prevent unnecessary network requests with the HTTP Cache。一年上限,HTML 用
no-cache。2026-11-20 核对。 - IETF,RFC 9111: HTTP Caching,2022 年 6 月。启发式有效期、
no-cache、no-store、Age。2026-11-20 核对。 - IETF,RFC 8246: HTTP Immutable Responses,2017 年 9 月。2026-11-20 核对。
- Cloudflare,Default cache behavior。会停止边缘缓存的源站响应头。2026-11-20 核对。
这篇文章对你有帮助吗?
我们会根据反馈修改和补充这篇内容。
提交没有成功,请稍后再试。
谢谢你的反馈,我们会据此改进这篇内容。你已经反馈过这篇了,谢谢。

