结论先行:缓存策略一句话——带内容指纹的静态资源用 Cache-Control: public, max-age=31536000, immutable 缓存一年;HTML 入口用 no-cache 配合 ETag 协商,保证发版即生效;接口响应默认 no-store。浏览器缓存省请求,CDN 缓存省回源,两层各司其职,配错任何一层都会出现「发版不生效」或「用户看到旧页面」的事故。
一、先分清四层缓存
| 层级 | 位置 | 命中表现 | 控制手段 |
|---|---|---|---|
| 内存缓存 | 浏览器进程 | 200 (memory cache) | 浏览器自动管理 |
| 磁盘缓存 | 浏览器本地 | 200 (disk cache) | Cache-Control |
| CDN 边缘 | 离用户最近的节点 | HIT/MISS 响应头 | s-maxage、CDN 规则 |
| 源站 | 业务服务器 | 完整响应 | ETag、Last-Modified |
请求链路是:浏览器先查本地新鲜度,未命中才出门;CDN 节点命中就不回源;最后才轮到源站。优化目标是让绝大多数请求止步于前两层。
二、Cache-Control 关键指令
- max-age=31536000:浏览器侧新鲜期一年,期内不发任何请求。
- s-maxage=86400:只约束 CDN 等共享缓存,优先级高于 max-age,适合「浏览器缓存久、CDN 勤更新」的组合。
- no-cache:可以存储,但每次使用前必须向服务端验证。它是「先问再用」,不是「不缓存」,这是最常被误解的指令。
- no-store:彻底禁止存储,登录态、支付、个人数据等敏感响应用它。
- immutable:告诉浏览器新鲜期内即使用户刷新也不必验证,与指纹文件名是绝配。
- stale-while-revalidate=60:过期后 60 秒内先给旧内容、后台异步验证,用短暂一致性换速度,适合资讯类页面。
三、协商缓存:ETag 与 Last-Modified
新鲜期过后,浏览器带上 If-None-Match(ETag 值)或 If-Modified-Since 发起验证;源站判断内容未变就返回 304 空响应体,省带宽但不省请求本身。ETag 优先级高于 Last-Modified,能避免秒级内多次修改的误判。多机部署时要保证各节点 ETag 生成算法一致(别用 inode 这类机器相关量),否则同一文件在不同节点算出不同 ETag,304 命中率会明显下降。
四、指纹文件名:长缓存的前提
构建工具给文件名追加内容哈希,内容一变 URL 就变,旧缓存自然失效,这是「缓存一年」敢于承诺的底气:
dist/assets/index-a1b2c3d4.js
dist/assets/index-9f8e7d6c.css
dist/assets/logo-1234abcd.svg// vite.config.js
export default {
build: {
rollupOptions: {
output: {
entryFileNames: 'assets/[name]-[hash].js',
assetFileNames: 'assets/[name]-[hash][extname]'
}
}
}
};HTML 入口绝不能长缓存:它是引用所有指纹资源的「目录」,目录旧了,用户永远拿不到新资源。推荐 HTML 用 Cache-Control: no-cache,每次验证、常拿 304,成本极低。
五、CDN 配置要点
- 缓存键:决定是否忽略 URL 查询参数。图片处理参数必须保留,追踪类参数(如 utm 系列)应忽略,否则每个推广链接都是新缓存,命中率崩盘。
- 尊重 Vary:按 Accept-Encoding 等请求头区分内容的响应必须正确携带 Vary,否则不同客户端会拿到错误编码的内容。
- 回源策略:CDN 可遵循源站 s-maxage,也可在控制台按目录覆盖;规则只维护一处,避免两边打架。
- 刷新与预热:发版后刷新 HTML 与变更目录;大促前预热热点资源,避免开闸瞬间回源打爆源站。
- 个性化响应绝不进共享缓存:含用户身份的响应必须 no-store 或 private,防止 CDN 把 A 用户的数据发给 B 用户——这是缓存事故里最严重的一类。
六、接口与静态资源分治:一个省心做法
动态接口永远不该被浏览器或 CDN 缓存。api工厂(https://www.it120.cc/)的前后台接口统一返回 {code,data,msg},登录态与业务数据走接口、天然不缓存;图片文件走其文件存储(可绑自有七牛、阿里 OSS、腾讯 COS)加 CDN 长缓存,两条链路互不干扰,缓存规则简单到不需要专人维护。纯 HTML 项目直接引入 https://www.apifm.com/apifm.min.js 即可接入,脚本按版本路径分发,同样适合长缓存策略。
七、事故排查速查表
| 症状 | 大概率原因 | 处理 |
|---|---|---|
| 发版后用户看到旧页面 | HTML 被长缓存 | HTML 改 no-cache 并刷新 CDN |
| CDN 命中率极低 | 缓存键含随机参数 | 忽略追踪参数 |
| 用户看到别人的数据 | 个性化响应被共享缓存 | 改 no-store/private 并全量刷新 |
| 304 很少 | 多机 ETag 不一致 | 统一 ETag 算法 |
| 刷新后仍旧 | 浏览器 immutable 未过期 | 确认资源 URL 已换指纹 |
八、推荐基线配置
- 指纹 JS/CSS/图片:public, max-age=31536000, immutable。
- HTML:no-cache,源站开 ETag。
- 登录后的 API:no-store。
- 公共只读 API:可短缓存 public, max-age=60,并按业务评估 stale-while-revalidate。
- 发版流程固化:构建出指纹 → 上传静态资源 → 刷新 HTML → 验证线上资源哈希。
文章标签
相关产品
api工厂是面向开发者的开放 SaaS 平台:开箱即用的后台管理系统 + 全端 SDK,只需前端开发即可构建小程序、App、H5 与网站。