选择缓存策略
发布于 更新于
缓存策略决定 Service Worker 怎样从缓存或网络响应请求。静态资源、动态数据和时效性强的内容
适合不同策略,还要考虑用户能接受多旧的响应。五种策略各自取舍内容新鲜度、响应速度和离线可用性,
可以写成普通函数,放进 sw.js 使用。
先准备好带 fetch 处理函数的 Service Worker,按请求选择策略的写法见
离线策略。这些函数使用 Cache 接口,它与 HTTP 缓存相互独立。Cache-Control
标头只决定浏览器 HTTP 缓存保留什么,不影响 cache.put() 存入的内容,也不限制 caches.match() 返回它的期限。
核心策略
链接到“核心策略”一节每个函数接收一个 Request、返回一个 Response,所以 fetch 处理函数可以写成
event.respondWith(strategy(event.request))。cache.put() 会消耗响应体,所以每个函数都先 clone() 再存。
缓存优先
链接到“缓存优先”一节先查缓存;只在未命中时走网络,并把结果存起来。
async function cacheFirst(request, cacheName = 'static') { const cached = await caches.match(request); if (cached) return cached; const response = await fetch(request); if (response.ok) { const cache = await caches.open(cacheName); cache.put(request, response.clone()); } return response;}JavaScript 包、CSS、图片和字体若使用带哈希版本号的 URL,且同一 URL 的内容不变,就适合缓存优先。 响应能立即返回,离线时也可用。但要刷新缓存,必须更换 Service Worker 版本或删除对应条目。
网络优先
链接到“网络优先”一节先试网络;请求失败时回退到缓存副本。
async function networkFirst(request, cacheName = 'dynamic', timeoutMs = 3000) { const cache = await caches.open(cacheName); try { const response = await Promise.race([ fetch(request), new Promise((_, reject) => setTimeout(() => reject(new Error('timeout')), timeoutMs)), ]); if (response.ok) cache.put(request, response.clone()); return response; } catch { const cached = await cache.match(request); if (cached) return cached; throw new Error(`no network and no cached copy for ${request.url}`); }}用于在线时需要最新版本、离线时上一次看到的版本仍有用的 HTML 与 API 响应。代价是每次请求都要等一次完整的 网络往返,网络不稳定时,用户要等到请求失败才能收到缓存响应;上面的超时限制了这段等待。
stale-while-revalidate
链接到“stale-while-revalidate”一节立即返回缓存的响应,同时在后台刷新缓存供下次使用。
async function staleWhileRevalidate(request, cacheName = 'dynamic') { const cache = await caches.open(cacheName); const cached = await cache.match(request); const refresh = fetch(request).then((response) => { if (response.ok) cache.put(request, response.clone()); return response; }); return cached || refresh;}头像、文章列表和 UI 框架需要快速加载,也需要较新的内容,但可以接受落后一个版本,适合用这个策略。 代价是每次加载多发一个请求,响应内容比当前版本恰好落后一次访问。
仅网络
链接到“仅网络”一节在 fetch 处理函数中省略 respondWith(),让浏览器直接处理请求,不查缓存,行为与没有 worker 时相同。
self.addEventListener('fetch', (event) => { if (event.request.method !== 'GET') return; // 仅网络:POST、PUT、DELETE});非 GET 请求、实时数据和不能使用旧版本的内容适合这个策略,但必须联网才能使用。
仅缓存
链接到“仅缓存”一节只从缓存提供,未命中即失败。
async function cacheOnly(request) { const cached = await caches.match(request); if (cached) return cached; return new Response('Not precached', { status: 504 });}应用外壳和离线回退页可以在 install 中预缓存,再用此策略读取。要更新内容,须等下一个 worker 版本预缓存新的一组资源。
为每类资源匹配策略
链接到“为每类资源匹配策略”一节| 资源类型 | 策略 | 原因 |
|---|---|---|
| 带哈希文件名的应用外壳(HTML、CSS、JavaScript) | 缓存优先 | 同一 URL 下不可变;首次访问后即时 |
| 图片与字体 | 缓存优先 | 很少变化;体积大到重新抓取很伤 |
| 导航请求 | 网络优先,配离线回退页 | 在线时 HTML 新鲜;离线时用缓存外壳或回退页 |
| 用户专属的 API 数据 | 网络优先 | 必须新鲜;缓存是离线兜底 |
| 共享或半静态的 API 数据 | stale-while-revalidate | 先从缓存绘制,为下次刷新 |
| POST、PUT、DELETE、WebSocket 升级 | 仅网络 | 无法从缓存提供 |
| 预缓存的离线页 | 仅缓存 | 存在的意义就是回退永不依赖网络 |
Workbox 在 workbox-strategies 中以类的形式提供同样五种:CacheFirst、NetworkFirst、
StaleWhileRevalidate、NetworkOnly 与 CacheOnly,用 registerRoute() 按路由注册。NetworkFirst
与 NetworkOnly 接受 networkTimeoutSeconds 选项,作用相当于上面的超时;Workbox 的 StaleWhileRevalidate
无论缓存条目多新都会发出重新验证请求。与自己维护手写函数相比,使用这个库会多出一个构建步骤和几 KB 体积。
按时间让条目过期
链接到“按时间让条目过期”一节Cache Storage 自身没有过期机制,caches.match() 会原样返回一个月前存入的响应。资源会变化、又不属于关键资源时,
检查响应的 Date 标头,把过旧的条目当作未命中。
async function cacheWithExpiry(request, maxAgeSeconds, cacheName = 'dynamic') { const cache = await caches.open(cacheName); const cached = await cache.match(request); if (cached) { const storedAt = new Date(cached.headers.get('date') || 0).getTime(); if (Date.now() - storedAt < maxAgeSeconds * 1000) return cached; await cache.delete(request); } const response = await fetch(request); if (response.ok) cache.put(request, response.clone()); return response;}Date 标头由服务器设置,任何一侧的时钟不准都会让过期时间偏移;把自己的时间戳连同缓存键存进 IndexedDB
更麻烦也更精确。Workbox 的 ExpirationPlugin 用 maxAgeSeconds 与 maxEntries 做这件事。
另请参阅
链接到“另请参阅”一节- 离线策略
- Service worker 缓存策略
- Cache Storage:离线 PWA 背后的请求/响应存储
- Workbox
- Strategies for service worker caching(developer.chrome.com)
- Service worker caching and HTTP caching(web.dev)
- workbox-strategies(developer.chrome.com)
← 返回指南总览。