Skip to content

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 等等。

查看术语表

动手做项目

通过引导式项目应用所学,含起始代码与解决方案。

查看项目

解读错误信息

用大白话解释常见错误——什么意思、为什么发生、如何修复。

查看错误