PWA 离线优先架构深入
设计离线优先 PWA:后台同步、冲突解决和本地数据持久化。
你将学到
- 离线优先设计哲学和 UX 模式
- IndexedDB 用于本地数据持久化
- Background Sync API 用于延迟请求
- 冲突解决:最后写入胜出与 CRDT
概念讲解
PWA 离线优先架构深入
离线优先意味着应用完全离线工作并在在线时同步,在不稳定网络上提供更好 UX。
设计哲学
假设网络不可靠。所有写入先到本地存储(IndexedDB),再同步。读取始终来自本地存储。UI 立即显示本地数据并指示同步状态。
IndexedDB
浏览器本地数据库:事务性、支持索引、处理大数据。与 localStorage 不同,IndexedDB 可异步存储 GB 级。用 idb 或 Dexie 提供 Promise API。
后台同步
Background Sync API 将网络请求延迟到有连接时。离线时注册 sync 事件。在线时 SW 触发 sync 重放排队请求,指数退避重试。
冲突解决
同步时如数据在两设备修改则冲突。策略:最后写入胜出(时间戳)、CRDT(数学保证收敛)、自定义合并(领域特定)。
示例代码
async function addTodo(text) {
const todo = {id: Date.now(), text, synced: false};
const db = await new Promise((res) => { const r = indexedDB.open('app', 1); r.onupgradeneeded = e => e.target.result.createObjectStore('todos', {keyPath:'id'}); r.onsuccess = e => res(e.target.result); });
db.transaction('todos', 'readwrite').objectStore('todos').put(todo);
console.log('Saved locally:', todo);
if ('SyncManager' in window) { const reg = await navigator.serviceWorker.ready; await reg.sync.register('sync-todos'); console.log('Sync registered'); }
}
self.addEventListener('sync', e => { if (e.tag === 'sync-todos') e.waitUntil(console.log('Syncing in background...')); });
console.log('Offline-first defined');
addTodo 保存到 IndexedDB 并注册后台同步。SW sync 事件在在线时触发,重放未同步项。
动手试一试
- JSON Formatter
离线数据以 JSON 存储在 IndexedDB——格式化用于调试。
常见错误
错误写法
不处理同步失败,使项永远未同步。
正确做法
跟踪同步尝试并显示失败项和重试按钮。不要静默丢弃数据。
错误写法
大数据用 localStorage 而非 IndexedDB。
正确做法
localStorage 限制 5MB 且阻塞主线程。重要数据用 IndexedDB。
查阅不认识的术语
新手友好的术语表用大白话解释编程术语——变量、函数、DOM、Promise 等等。
动手做项目
通过引导式项目应用所学,含起始代码与解决方案。
解读错误信息
用大白话解释常见错误——什么意思、为什么发生、如何修复。