PWA(Progressive Web App)在 2026 年已經不再是"能不能替代原生 App"的討論焦點。App Store 和 Google Play 依然強勢,但 PWA 找到了自己的定位:不需要分發渠道更新、離線場景可用、安裝即用。這些特性讓 PWA 在內部工具、內容型應用、新興市場場景中持續發揮作用。而 PWA 的技術基石——Service Worker——依然是前端最複雜也最強大的 API 之一。
Service Worker 的生命周期和事件模型
Service Worker 是運行在瀏覽器主線程之外的獨立線程,充當網頁和網絡之間的代理。它有自己的生命周期,與頁面生命周期完全獨立。
安裝中 (installing) → 安裝完成 (installed) → 激活中 (activating) → 激活完成 (activated) → 廢棄 (redundant)
// sw.ts - Service Worker 入口
const CACHE_VERSION = 'v3';
const STATIC_CACHE = `static-${CACHE_VERSION}`;
const RUNTIME_CACHE = `runtime-${CACHE_VERSION}`;
// install 事件:預緩存關鍵資源
self.addEventListener('install', (event: ExtendableEvent) => {
event.waitUntil(
caches.open(STATIC_CACHE).then((cache) =>
cache.addAll([
'/',
'/offline.html',
'/styles/main.css',
'/scripts/app.js',
'/images/logo.svg',
]),
),
);
});
// activate 事件:清理舊緩存
self.addEventListener('activate', (event: ExtendableEvent) => {
event.waitUntil(
caches.keys().then((cacheNames) =>
Promise.all(
cacheNames
.filter((name) => !name.includes(CACHE_VERSION))
.map((name) => caches.delete(name)),
),
),
);
// 立即接管所有頁面(不等頁面刷新)
self.clients.claim();
});
// fetch 事件:攔截網絡請求
self.addEventListener('fetch', (event: FetchEvent) => {
const { request } = event;
// 非 GET 請求直接走網絡
if (request.method !== 'GET') return;
// 不同資源用不同緩存策略
if (request.destination === 'document') {
event.respondWith(handleNavigation(request));
} else if (isStaticAsset(request.url)) {
event.respondWith(handleStaticAsset(request));
} else if (isApiRequest(request.url)) {
event.respondWith(handleApiRequest(request));
}
});
理解 Service Worker 生命周期的關鍵點:新版本的 Service Worker 不會立即替換舊版本。當用戶首次訪問時安裝 v1,下次訪問發現 v2 會安裝 v2 但不會立即激活——v1 仍在控制當前頁面。只有當所有使用 v1 的頁面都關閉後,v2 才會激活。這是 Service Worker 更新策略設計的核心約束。
離線優先架構的核心思想
離線優先(Offline First)不是"離線也能用",而是把緩存作爲首要數據源,網絡作爲更新手段。傳統 Web 應用的默認行爲是"網絡優先"——每次請求都打網絡,網絡失敗才報錯。離線優先把這個順序倒過來:先從緩存返回數據(立即響應),同時在後臺請求網絡更新緩存。
這個思維轉變的影響是深遠的:
- 頁面加載速度不再依賴網絡——緩存命中時近乎瞬時
- 網絡不穩定場景下用戶體驗一致——不會因爲斷網而白屏
- 需要處理緩存一致性問題——緩存數據可能過期
緩存策略矩陣
Workbox 提供了五種核心緩存策略,每種適用於不同的資源類型:
// 不同資源的緩存策略映射
const strategies = {
// 1. Cache First:先查緩存,緩存命中直接返回,未命中才查網絡
// 適用:靜態資源(字體、圖片、CSS/JS bundle)
staticAssets: new CacheFirst({
cacheName: 'static-assets',
plugins: [
new CacheableResponsePlugin({ statuses: [0, 200] }),
new ExpirationPlugin({
maxEntries: 60,
maxAgeSeconds: 30 * 24 * 60 * 60, // 30 天
}),
],
}),
// 2. Network First:先查網絡,成功則更新緩存,失敗則用緩存
// 適用:動態內容(API 響應、HTML 文檔)
dynamicContent: new NetworkFirst({
cacheName: 'dynamic-content',
networkTimeoutSeconds: 3, // 3 秒超時降級到緩存
plugins: [
new CacheableResponsePlugin({ statuses: [0, 200] }),
new ExpirationPlugin({
maxEntries: 50,
maxAgeSeconds: 24 * 60 * 60, // 1 天
}),
],
}),
// 3. Stale While Revalidate:立即返回緩存,同時後臺更新緩存
// 適用:頻繁更新但舊數據可用的資源(如用戶頭像、非關鍵 API)
semiStatic: new StaleWhileRevalidate({
cacheName: 'semi-static',
plugins: [
new CacheableResponsePlugin({ statuses: [0, 200] }),
new ExpirationPlugin({
maxEntries: 100,
maxAgeSeconds: 7 * 24 * 60 * 60, // 7 天
}),
],
}),
// 4. Network Only:只走網絡,不緩存
// 適用:不可緩存的數據(如實時價格、敏感操作)
// 5. Cache Only:只走緩存,不查網絡
// 適用:離線頁面、靜態資源兜底
};
策略選型的核心是回答兩個問題:舊數據能不能用 和 數據更新頻率多高。
| 資源類型 | 舊數據可用? | 更新頻率 | 推薦策略 |
|---|---|---|---|
| JS/CSS bundle | 可以 | 每次部署 | Cache First |
| 字體文件 | 可以 | 極低 | Cache First |
| HTML 文檔 | 可以(離線兜底) | 中 | Network First |
| 列表 API | 可以(短期) | 高 | Stale While Revalidate |
| 實時數據 API | 不可以 | 極高 | Network Only |
| 用戶操作寫入 | 不適用 | N/A | Network Only + 後臺同步 |
Workbox 的工程化使用
手動寫 Service Worker 的緩存邏輯容易出錯,Workbox 把這些複雜性封裝成了可配置的模塊。2026 年的標準做法是用 Vite 插件集成 Workbox:
// vite.config.ts
import { defineConfig } from 'vite';
import { VitePWA } from 'vite-plugin-pwa';
export default defineConfig({
plugins: [
VitePWA({
strategies: 'injectManifest',
srcDir: 'src',
filename: 'sw.ts',
registerType: 'prompt', // 有新版本時提示用戶刷新
injectRegister: false,
// 注入預緩存清單
injectManifest: {
globPatterns: ['**/*.{js,css,html,svg,png,woff2}'],
maximumFileSizeToCacheInBytes: 3 * 1024 * 1024,
},
// 開發環境禁用
devOptions: {
enabled: false,
},
}),
],
});
// src/sw.ts - 自定義 Service Worker(使用 Workbox 模塊)
import { precacheAndRoute, cleanupOutdatedCaches } from 'workbox-precaching';
import { registerRoute, NavigationRoute } from 'workbox-routing';
import { CacheFirst, NetworkFirst, StaleWhileRevalidate } from 'workbox-strategies';
import { ExpirationPlugin } from 'workbox-expiration';
import { CacheableResponsePlugin } from 'workbox-cacheable-response';
import { BackgroundSyncPlugin } from 'workbox-background-sync';
// 預緩存(清單由 Vite 插件注入)
precacheAndRoute(self.__WB_MANIFEST);
cleanupOutdatedCaches();
// 導航請求:Network First + 離線兜底頁
const navigationRoute = new NavigationRoute(
new NetworkFirst({
cacheName: 'pages',
networkTimeoutSeconds: 3,
plugins: [new CacheableResponsePlugin({ statuses: [0, 200] })],
}),
{
denylist: [/^\/api/, /^\/admin/],
},
);
registerRoute(navigationRoute);
// 靜態資源:Cache First
registerRoute(
({ request }) =>
request.destination === 'style' ||
request.destination === 'script' ||
request.destination === 'font',
new CacheFirst({
cacheName: 'static-resources',
plugins: [
new CacheableResponsePlugin({ statuses: [0, 200] }),
new ExpirationPlugin({
maxEntries: 60,
maxAgeSeconds: 30 * 24 * 60 * 60,
}),
],
}),
);
// 圖片:Stale While Revalidate
registerRoute(
({ request }) => request.destination === 'image',
new StaleWhileRevalidate({
cacheName: 'images',
plugins: [
new CacheableResponsePlugin({ statuses: [0, 200] }),
new ExpirationPlugin({
maxEntries: 100,
maxAgeSeconds: 7 * 24 * 60 * 60,
}),
],
}),
);
// API 請求:Stale While Revalidate
registerRoute(
({ url }) => url.pathname.startsWith('/api/'),
new StaleWhileRevalidate({
cacheName: 'api-cache',
plugins: [
new CacheableResponsePlugin({ statuses: [0, 200] }),
new ExpirationPlugin({
maxEntries: 50,
maxAgeSeconds: 5 * 60, // 5 分鐘
}),
],
}),
);
消息推送(Push Notification)
Push Notification 是 PWA 最接近原生 App 體驗的能力。完整鏈路涉及:服務端 VAPID 密鑰對 → 用戶訂閱 → 服務端推送 → Service Worker 接收 → 顯示通知。
// 客戶端:訂閱推送
async function subscribeToPush() {
const registration = await navigator.serviceWorker.ready;
// 檢查是否已訂閱
const existing = await registration.pushManager.getSubscription();
if (existing) return existing;
// 獲取 VAPID 公鑰
const vapidPublicKey = await fetch('/api/push/vapid-key').then((r) => r.text());
const convertedKey = urlBase64ToUint8Array(vapidPublicKey);
const subscription = await registration.pushManager.subscribe({
userVisibleOnly: true, // 必須爲 true:推送必須顯示通知
applicationServerKey: convertedKey,
});
// 將訂閱信息發送到服務端
await fetch('/api/push/subscribe', {
method: 'POST',
body: JSON.stringify(subscription),
headers: { 'Content-Type': 'application/json' },
});
return subscription;
}
function urlBase64ToUint8Array(base64String: string): Uint8Array {
const padding = '='.repeat((4 - (base64String.length % 4)) % 4);
const base64 = (base64String + padding).replace(/-/g, '+').replace(/_/g, '/');
const rawData = atob(base64);
return Uint8Array.from(rawData.split('').map((c) => c.charCodeAt(0)));
}
// Service Worker:處理推送事件
self.addEventListener('push', (event: PushEvent) => {
const payload = event.data?.json() ?? {};
const options: NotificationOptions = {
body: payload.body,
icon: '/images/icon-192.png',
badge: '/images/badge-72.png',
data: {
url: payload.url,
},
actions: payload.actions ?? [],
tag: payload.tag, // 同 tag 的通知會替換,避免堆積
requireInteraction: payload.urgent ?? false,
};
event.waitUntil(
self.registration.showNotification(payload.title, options),
);
});
// 通知點擊:聚焦窗口或打開 URL
self.addEventListener('notificationclick', (event: NotificationEvent) => {
event.notification.close();
const targetUrl = event.notification.data?.url || '/';
event.waitUntil(
(async () => {
const allClients = await self.clients.matchAll({
type: 'window',
includeUncontrolled: true,
});
// 如果已有打開的窗口,聚焦它
for (const client of allClients) {
if (client.url === targetUrl && 'focus' in client) {
return client.focus();
}
}
// 否則打開新窗口
return self.clients.openWindow(targetUrl);
})(),
);
});
推送通知的一個關鍵限制:iOS Safari 在 16.4 之後才支持 Web Push,且需要用戶先將網站添加到主屏幕。這限制了推送通知在 iOS 上的覆蓋面。
後臺同步(Background Sync)
後臺同步解決的問題是:用戶離線時執行的操作(如發送消息、提交表單)在恢復網絡後自動重試。這保障了數據一致性——用戶的操作不會因爲網絡中斷而丟失。
// Service Worker:後臺同步
const bgSyncPlugin = new BackgroundSyncPlugin('failed-requests', {
maxRetentionTime: 24 * 60, // 重試保留 24 小時
onSync: async ({ queue }) => {
let entry;
while ((entry = await queue.shiftRequest())) {
try {
await fetch(entry.request.clone());
// 成功後通知客戶端
const clients = await self.clients.matchAll();
clients.forEach((client) =>
client.postMessage({ type: 'SYNC_SUCCESS', url: entry.request.url }),
);
} catch (error) {
// 重試失敗,放回隊列
await queue.unshiftRequest(entry);
throw error; // 拋出錯誤,Workbox 會在下次同步時重試
}
}
},
});
// 註冊 POST 請求的後臺同步
registerRoute(
({ request }) => request.method === 'POST',
new NetworkOnly({ plugins: [bgSyncPlugin] }),
'POST',
);
// 客戶端:註冊後臺同步
async function submitForm(data: FormData) {
try {
const response = await fetch('/api/submit', {
method: 'POST',
body: JSON.stringify(data),
headers: { 'Content-Type': 'application/json' },
});
return response.json();
} catch (error) {
// 網絡失敗時註冊後臺同步
const registration = await navigator.serviceWorker.ready;
if ('sync' in registration) {
await registration.sync.register('submit-form');
// 通知用戶:數據將在網絡恢復後同步
showOfflineToast('數據已保存,網絡恢復後將自動同步');
} else {
// 不支持 Background Sync 的瀏覽器降級到本地存儲
await saveToIndexedDB('pending-submits', data);
}
}
}
更新策略:讓用戶獲取最新版本
Service Worker 的更新是最容易出問題的環節。新版本安裝後不會立即激活,用戶可能一直使用舊版本。需要設計一個更新提示流程:
// 客戶端:Service Worker 更新管理
class SWUpdateManager {
private registration: ServiceWorkerRegistration | null = null;
async init() {
if (!('serviceWorker' in navigator)) return;
this.registration = await navigator.serviceWorker.register('/sw.js');
// 監聽新 Service Worker 安裝
this.registration.addEventListener('updatefound', () => {
const newWorker = this.registration!.installing;
if (!newWorker) return;
newWorker.addEventListener('statechange', () => {
if (newWorker.state === 'installed') {
if (navigator.serviceWorker.controller) {
// 已有舊版本在控制頁面 → 新版本已安裝,等待激活
this.showUpdatePrompt();
}
// 否則是首次安裝,不需要提示
}
});
});
// 監聽控制權變化
navigator.serviceWorker.addEventListener('controllerchange', () => {
// 新 Service Worker 已接管,刷新頁面
window.location.reload();
});
// 每小時檢查一次更新
setInterval(() => {
this.registration?.update();
}, 60 * 60 * 1000);
}
private showUpdatePrompt() {
// 顯示更新提示 UI
const toast = createUpdateToast({
message: '有新版本可用',
actionText: '刷新',
onAction: () => this.skipWaiting(),
});
document.body.appendChild(toast);
}
private skipWaiting() {
// 通知等待中的 Service Worker 立即激活
this.registration?.waiting?.postMessage({ type: 'SKIP_WAITING' });
}
}
// Service Worker 端:接收 skip waiting 消息
self.addEventListener('message', (event) => {
if (event.data?.type === 'SKIP_WAITING') {
self.skipWaiting();
}
});
更新策略的選擇取決於應用類型:
- 內容型應用:用
registerType: 'prompt',讓用戶主動刷新 - 工具型應用:用
registerType: 'autoUpdate',下次訪問自動更新 - 關鍵業務應用:配合服務端 API 檢查版本兼容性,不兼容時強制更新
調試技巧
Chrome DevTools 的 Application 面板是調試 Service Worker 的核心工具:
- Service Workers 列表:查看已註冊的 SW 狀態、手動 unregister、觸發 update
- Cache Storage:查看緩存內容、手動刪除緩存條目
- Offline / Update on reload / Bypass for network:三個調試開關
Offline:模擬離線Update on reload:每次刷新都重新安裝 SW(開發必備)Bypass for network:SW 不攔截請求,便於排查是否是緩存導致的問題
- Push messages:模擬推送,不需要服務端
開發時常見的坑:修改 Service Worker 代碼後不生效。原因是 Update on reload 沒開,舊 SW 一直在控制頁面。開發階段始終開啓這個選項。
與 App Shell 模型的結合
App Shell 模型是 PWA 的一種架構模式:把應用的"外殼"(導航欄、側邊欄、布局框架)預緩存到 Service Worker,首次加載後後續訪問瞬時顯示外殼,再用 JS 動態填充內容。
// App Shell 的導航路由處理
registerRoute(
({ request }) => request.mode === 'navigate',
async () => {
// 導航請求返回緩存的 app shell
const cache = await caches.open('app-shell');
const cached = await cache.match('/shell.html');
if (cached) {
// 後臺更新 shell
fetch('/shell.html').then((response) => {
cache.put('/shell.html', response.clone());
});
return cached;
}
// 首次加載:從網絡獲取
const response = await fetch('/shell.html');
cache.put('/shell.html', response.clone());
return response;
},
);
App Shell 模型在 SPA 中效果最好——Shell 加載後由客戶端路由接管,頁面切換不產生網絡請求。但對於 SSR 應用,App Shell 的價值有限,因爲 SSR 本身已經能快速返回首屏內容。
PWA 在 2026 年的定位
2026 年的 PWA 不再是"替代原生 App"的敘事,而是特定場景的最優解:
- 內部工具和企業應用:不需要經過 App Store 審核,直接分發 URL
- 新興市場:低端設備和有限網絡環境下,離線能力是剛需
- 內容型應用:新聞、博客、文檔站,離線閱讀是自然需求
- 安裝門檻高的場景:用戶不願意爲一個低頻應用安裝 App
PWA 不適合的場景:需要大量原生 API(藍牙、NFC、文件系統深度集成)、對推送通知到達率要求極高(iOS 推送受限)、需要出現在應用商店搜索結果中。
小結
Service Worker 和離線優先架構的核心在於:理解緩存策略矩陣並按資源特性選擇策略,用 Workbox 工程化緩存管理,用 Background Sync 保障數據一致性,用推送通知提升用戶回訪,設計合理的更新流程讓用戶及時獲取新版本。PWA 在 2026 年的定位是特定場景的最優解而非萬能方案——選擇 PWA 不是因爲它比原生 App 更好,而是因爲它的分發成本、更新效率和離線能力恰好匹配業務需求。理解 Service Worker 的生命周期和緩存策略是正確實現 PWA 的前提,而調試技巧和更新策略則是生產環境穩定運行的保障。
