跨平台开发 / 系统课时

避免网络和本地数据互相覆盖

避免网络和本地数据互相覆盖

当应用同时存在旧缓存、最新接口结果和尚未同步的本地修改时,最危险的做法是“谁最后写入谁赢”。本节将建立明确的版本与脏数据规则,让网络刷新不会冲掉本地编辑,也让过期缓存不能反向覆盖新数据。

学习目标

  • 区分缓存版本、服务端版本和本地未同步修改
  • 设计可预测的数据合并与写入优先级
  • 在刷新、编辑和同步场景中避免旧数据覆盖新数据

先定义三类数据的权利边界

同一条记录可能同时存在三个副本:磁盘里的旧缓存、接口返回的新版本、本地刚编辑但还没上传的版本。它们不能只凭“最后到达时间”决定谁覆盖谁,因为网络响应可能晚到,本地写盘也可能异步完成。

更稳妥的规则是:已确认的服务端版本可以替换更旧的干净缓存;本地未同步修改不能被普通刷新覆盖;缓存只能作为启动和离线读取来源,不能反向覆盖已确认的新版本。

网络缓存与本地修改合并关系

用版本号和 dirty 标记阻止误覆盖

下面的 Dart 示例用 revision 表示服务端版本,用 dirty 表示本地是否存在未同步修改。刷新时,如果本地仍是 dirty 状态,就不允许远端响应直接覆盖它。

dart
class Note {
  final String text;
  final int revision;
  final bool dirty;

  const Note({
    required this.text,
    required this.revision,
    required this.dirty,
  });

  @override
  String toString() =>
      'Note(text: $text, revision: $revision, dirty: $dirty)';
}

Note mergeRemote(Note local, Note remote) {
  // 未同步的本地修改拥有临时保护权,普通刷新不得覆盖。
  if (local.dirty) {
    return local;
  }

  // 只有更高版本的服务端数据才能替换当前干净副本。
  if (remote.revision > local.revision) {
    return remote;
  }
  return local;
}

void main() {
  const localEdit = Note(text: 'draft locally', revision: 5, dirty: true);
  const remoteRefresh = Note(text: 'server value', revision: 6, dirty: false);

  final merged = mergeRemote(localEdit, remoteRefresh);
  print(merged);
}

预期输出

text
Note(text: draft locally, revision: 5, dirty: true)

这个例子故意保留本地编辑,并不表示本地内容永远优先。当用户真正执行同步时,还需要把“本地编辑基于哪个服务端版本”一起提交;如果服务器当前版本已经变化,就进入冲突处理,而不是偷偷覆盖任一方。

把读取、刷新和同步分开

很多覆盖问题来自一个 Repository 方法同时承担太多职责。可以把动作拆成三类,并规定每类动作允许写哪里。

动作 可读取 可写入 关键限制
启动读取 缓存 内存状态 只用于快速展示
网络刷新 服务端 内存、干净缓存 不覆盖 dirty 本地修改
本地编辑 当前内存 本地存储 标记 dirty,并保存基线版本
同步成功 本地修改、服务端 内存、缓存 清除 dirty,更新为服务器确认版本

这样做后,“刷新”和“同步”就不再是同一个概念。刷新用于拿服务器最新状态;同步用于提交本地修改并处理冲突。两者分开,覆盖规则才容易测试。

防止异步响应倒序写回

即使没有本地编辑,也可能出现两个刷新请求并发:请求 A 先发后回,请求 B 后发先回。如果只按完成顺序写缓存,较旧的 A 可能最后落盘,把 B 的新数据覆盖掉。

解决方法仍然是比较版本,而不是比较回调先后。服务端若提供 ETag、更新时间或单调递增版本号,应优先使用这些字段;如果接口没有任何版本信息,客户端只能通过请求序号等方式降低倒序写回风险,但无法可靠判断业务数据的新旧。

稳定的协同策略不是“本地优先”或“网络优先”这么简单,而是先区分数据是否已被服务器确认、是否有未同步修改,再依据版本关系决定写入。只要覆盖条件显式化,刷新、离线读取和同步就能各司其职。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

避免网络和本地数据互相覆盖

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通