跳转到内容

选择缓存策略

发布于 更新于

缓存策略决定 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 响应。代价是每次请求都要等一次完整的 网络往返,网络不稳定时,用户要等到请求失败才能收到缓存响应;上面的超时限制了这段等待。

立即返回缓存的响应,同时在后台刷新缓存供下次使用。

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 做这件事。

← 返回指南总览。