indexeddb可通过“本地操作队列+状态标记+后台同步”实现离线表单可靠同步:1.建sync_queue表存带状态的任务;2.提交时写入队列并更新ui;3.联网后按序幂等同步,含重试与错误处理;4.同步后清理或审计,并防多标签冲突。

IndexedDB 可以通过“本地操作队列 + 状态标记 + 后台同步”三步实现离线表单数据的可靠同步。核心不是单纯存数据,而是把每次提交动作建模为一条带状态的待执行任务,等网络恢复后再按序、幂等地提交到服务端。
1. 设计同步任务表(sync_queue)
创建一个专用 ObjectStore 存储待同步的操作,每条记录包含:唯一 ID、表单原始数据(JSON)、操作类型(create/update/delete)、时间戳、重试次数、当前状态(pending/syncing/success/failed)。
示例结构:
{"id": "task_20241105_abc123",
"type": "create",
"payload": {"name": "张三", "email": "zhang@example.com"},
"createdAt": 1730825640123,
"retries": 0,
"status": "pending"
}
2. 表单提交时写入队列而非直连后端
用户点击提交后,先序列化表单数据,生成任务对象,用 add() 写入 sync_queue。成功后立即更新 UI(如显示“已保存至本地,稍后同步”),不等待网络。
关键点:
- 使用事务的 readwrite 模式确保写入原子性
- 为每条任务生成客户端唯一 ID(如 Date.now() + 随机后缀),避免重复插入
- 可选:在写入前检查网络状态,若在线则跳过队列直接提交(但建议统一走队列,逻辑更一致)
3. 网络恢复时自动触发同步(含错误处理与重试)
监听 navigator.onLine 或更可靠的 fetch 探测(如定时请求 /health 端点),检测到联网后启动同步流程:
- 按 createdAt 升序 查询 status === 'pending' 的任务(保证时序)
- 逐条发起 fetch 请求,带上任务 ID 和 payload;成功后用 put() 更新该任务 status = 'success'
- 失败时:status = 'failed',retries += 1;若 retries ≥ 3,可标记为 'blocked' 并通知用户手动处理
- 同步中设置 status = 'syncing',防止重复触发
注意:服务端接口需支持幂等(例如用客户端 task_id 做去重键),避免重复提交。
4. 清理与监控(可选但推荐)
同步成功后,可保留任务记录若干天用于审计,或调用 delete() 彻底清除。同时提供简单 UI 展示队列长度、最近失败项,帮助用户感知离线状态。
补充技巧:
- 用 IDBKeyRange.bound() 分页拉取大量待同步任务,避免内存溢出
- 同步过程加锁(如用 localStorage 标记 syncing=true)防止多标签冲突
- 页面卸载前(beforeunload)尝试快速同步几条高优任务
Java免费学习笔记:立即使用
解锁 Java 大师之旅:从入门到精通的终极指南











