跨平台开发 / 系统课时
避免网络和本地数据互相覆盖
避免网络和本地数据互相覆盖
当应用同时存在旧缓存、最新接口结果和尚未同步的本地修改时,最危险的做法是“谁最后写入谁赢”。本节将建立明确的版本与脏数据规则,让网络刷新不会冲掉本地编辑,也让过期缓存不能反向覆盖新数据。
学习目标
- 区分缓存版本、服务端版本和本地未同步修改
- 设计可预测的数据合并与写入优先级
- 在刷新、编辑和同步场景中避免旧数据覆盖新数据
先定义三类数据的权利边界
同一条记录可能同时存在三个副本:磁盘里的旧缓存、接口返回的新版本、本地刚编辑但还没上传的版本。它们不能只凭“最后到达时间”决定谁覆盖谁,因为网络响应可能晚到,本地写盘也可能异步完成。
更稳妥的规则是:已确认的服务端版本可以替换更旧的干净缓存;本地未同步修改不能被普通刷新覆盖;缓存只能作为启动和离线读取来源,不能反向覆盖已确认的新版本。

用版本号和 dirty 标记阻止误覆盖
下面的 Dart 示例用 revision 表示服务端版本,用 dirty 表示本地是否存在未同步修改。刷新时,如果本地仍是 dirty 状态,就不允许远端响应直接覆盖它。
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);
}预期输出
Note(text: draft locally, revision: 5, dirty: true)这个例子故意保留本地编辑,并不表示本地内容永远优先。当用户真正执行同步时,还需要把“本地编辑基于哪个服务端版本”一起提交;如果服务器当前版本已经变化,就进入冲突处理,而不是偷偷覆盖任一方。
把读取、刷新和同步分开
很多覆盖问题来自一个 Repository 方法同时承担太多职责。可以把动作拆成三类,并规定每类动作允许写哪里。
| 动作 | 可读取 | 可写入 | 关键限制 |
|---|---|---|---|
| 启动读取 | 缓存 | 内存状态 | 只用于快速展示 |
| 网络刷新 | 服务端 | 内存、干净缓存 | 不覆盖 dirty 本地修改 |
| 本地编辑 | 当前内存 | 本地存储 | 标记 dirty,并保存基线版本 |
| 同步成功 | 本地修改、服务端 | 内存、缓存 | 清除 dirty,更新为服务器确认版本 |
这样做后,“刷新”和“同步”就不再是同一个概念。刷新用于拿服务器最新状态;同步用于提交本地修改并处理冲突。两者分开,覆盖规则才容易测试。
防止异步响应倒序写回
即使没有本地编辑,也可能出现两个刷新请求并发:请求 A 先发后回,请求 B 后发先回。如果只按完成顺序写缓存,较旧的 A 可能最后落盘,把 B 的新数据覆盖掉。
解决方法仍然是比较版本,而不是比较回调先后。服务端若提供 ETag、更新时间或单调递增版本号,应优先使用这些字段;如果接口没有任何版本信息,客户端只能通过请求序号等方式降低倒序写回风险,但无法可靠判断业务数据的新旧。
稳定的协同策略不是“本地优先”或“网络优先”这么简单,而是先区分数据是否已被服务器确认、是否有未同步修改,再依据版本关系决定写入。只要覆盖条件显式化,刷新、离线读取和同步就能各司其职。