跳到主要内容
api工厂
性能优化

浏览器缓存与 CDN 策略:Cache-Control、ETag 与指纹文件名

api工厂资讯栏目 约 5 分钟阅读
本文由 AI 辅助生成,内容基于公开资讯整理改写,技术细节以官方文档为准。

结论先行:缓存策略一句话——带内容指纹的静态资源用 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 就变,旧缓存自然失效,这是「缓存一年」敢于承诺的底气:

text
dist/assets/index-a1b2c3d4.js
dist/assets/index-9f8e7d6c.css
dist/assets/logo-1234abcd.svg
js
// 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 配置要点

  1. 缓存键:决定是否忽略 URL 查询参数。图片处理参数必须保留,追踪类参数(如 utm 系列)应忽略,否则每个推广链接都是新缓存,命中率崩盘。
  2. 尊重 Vary:按 Accept-Encoding 等请求头区分内容的响应必须正确携带 Vary,否则不同客户端会拿到错误编码的内容。
  3. 回源策略:CDN 可遵循源站 s-maxage,也可在控制台按目录覆盖;规则只维护一处,避免两边打架。
  4. 刷新与预热:发版后刷新 HTML 与变更目录;大促前预热热点资源,避免开闸瞬间回源打爆源站。
  5. 个性化响应绝不进共享缓存:含用户身份的响应必须 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 已换指纹

八、推荐基线配置

  1. 指纹 JS/CSS/图片:public, max-age=31536000, immutable。
  2. HTML:no-cache,源站开 ETag。
  3. 登录后的 API:no-store。
  4. 公共只读 API:可短缓存 public, max-age=60,并按业务评估 stale-while-revalidate。
  5. 发版流程固化:构建出指纹 → 上传静态资源 → 刷新 HTML → 验证线上资源哈希。

文章标签

浏览器缓存CDNCache-ControlETag前端工程化

相关产品

api工厂是面向开发者的开放 SaaS 平台:开箱即用的后台管理系统 + 全端 SDK,只需前端开发即可构建小程序、App、H5 与网站。

HTTP/3QUIC网络协议

HTTP/3 与 QUIC:前端能感知到什么收益

HTTP/3 普及已过临界点,前端无需改代码即可受益:1-RTT 握手、丢包不阻塞整条连接、网络切换不断连。文中给出启用、验证与监控的完整操作路径。

性能优化约 5 分钟阅读
Core Web VitalsINPLCP

Core Web Vitals 实战:LCP、INP、CLS 达标清单

以真实用户 p75 数据为准,给出 LCP、INP、CLS 三项核心指标的达标阈值、测量工具与逐项修复清单,并说明 INP 取代 FID 后前端优化重点的变化。

性能优化约 6 分钟阅读