网页端离线应用应在页面关闭前可靠发送缓存数据,核心是利用pagehide事件触发sendBeacon;数据需提前持久化至localStorage或IndexedDB并标记待上报;服务端须幂等处理且异步落库。

网页端离线应用在用户关闭页面前同步数据,核心不是“等网络恢复再发”,而是**在页面还活着的最后一刻,把已缓存的离线数据可靠发出**。Beacon 正是为此设计的——它不依赖在线状态实时成功,但能最大限度利用浏览器卸载前的窗口期完成入队,由浏览器后台进程尽力送达。
离线数据必须先本地持久化
用户可能在无网状态下操作很久,关闭页面时才触发同步。所以不能只靠 Beacon 临时收集,而要提前存好:
- 所有关键操作(如表单填写、编辑草稿、点击行为)都立即写入 localStorage 或 IndexedDB,带时间戳和唯一 ID
- 每次写入后标记为 “待上报” 状态,避免重复发送
- 建议用结构化方式存储,例如:
{ id: 'draft_123', type: 'note', content: '...', timestamp: 1728754920, synced: false }
用 pagehide 替代 unload 捕获关闭时机
unload 事件在现代浏览器中已被弱化,部分场景(如 Android Chrome 切后台)甚至不触发。pagehide 更可靠,覆盖刷新、关闭、导航、锁屏、切后台全部情况:
- 监听
pagehide,并在事件回调中读取本地未同步数据 - 构造轻量 payload:只传必要字段,比如
user_id、batch_id、items(数组序列化为字符串) - 避免在事件里做复杂计算或 await,保持执行快、无副作用
sendBeacon 发送前做精简与降级
Beacon 不支持自定义 header,也无法携带 token,服务端需适配简单请求;同时它对体积敏感:
- 数据转成 URLSearchParams 或 FormData,自动满足
application/x-www-form-urlencoded类型要求 - 总大小控制在 64KB 内(Chrome 限制),超限会静默失败;可分批发送,每批加
batch_seq字段 - 调用前检查支持性:
if ('sendBeacon' in navigator);返回false时降级为 localStorage 记录待补报,下次打开页面时主动重试
服务端配合:幂等 + 异步落库
Beacon 请求不可取消、不等响应,且可能因刷新+关闭被触发两次。服务端不能假设“一次请求=一次有效操作”:
- 接收端校验
user_id + batch_id + timestamp组合,已有记录则直接忽略或覆盖 - 不要在接口里做耗时处理(如发邮件、调第三方);只做快速入库,后续用消息队列异步消费
- 响应码保持 200,Body 可为空;Beacon 本就不读响应,返回非 2xx 可能干扰浏览器调度











