鸿蒙灵感笔记的本地优先同步:先落库、再同步的三个关键取舍
灵感来得很快,消失得也很快。打开 App、点一下“+”、写两行字、拍一张图,这个动作如果还要等网络返回,用户就会放弃记录。鸿蒙灵感笔记案例的答案很直接:写操作先落本地,登录之后再同步到云端。落地要处理三个取舍:本地以什么为准、同步以什么为序、冲突以什么为准。
一、本地是唯一可信的写入入口
端侧用 relationalStore 作为结构化数据的主数据源,图片和录音放在应用文件沙箱里。新建一条灵感时,App 先把标题、正文、类型、标签写进本地数据库,图片和录音先落盘、只把路径写进记录,界面随即刷新,全程不依赖网络。
这样做的好处是响应确定:离线、地铁、电梯里都能记。代价是本地必须足够可靠:写入要放在事务里,媒体先落盘再写记录,避免“记录有了、文件没了”;删除时先删记录再删文件,或用定时清理兜底。
二、同步队列决定了顺序,而不是网络决定
本地写完不等于同步完成。案例的做法是给每一次写操作留一条同步记录:操作类型是新增、修改还是删除,对应哪条笔记,内容快照是什么,时间戳是多少。登录拿到令牌后,后台任务按顺序消费队列表,逐条调用服务端接口;成功标记已同步,失败保留下来等下一次重试。
顺序比速度重要。同一条笔记先改标题、后改标签,如果两条记录乱序到达服务端,最终状态就可能倒退。所以队列要按时间戳和操作序号严格排序,服务端也要按版本接收。图片和录音单独处理:先传结构化数据,再传媒体,媒体失败只重试媒体。
服务端用 NestJS 提供接口,Prisma 把数据写进 MySQL,媒体文件保存到服务器受控目录。关键是两点:增量拉取接口按最后同步时间返回此后的变更,避免全量同步;单条写入接口带上客户端最后修改时间,让服务端判断写入是否过期。
三、冲突不要假装不存在,要分级处理
典型场景是:同一条笔记在手机上改了还没同步,在另一台设备上也改了并且已经同步到云端。第一台设备登录后推送时,客户端时间戳比服务端旧,内容又不一样,这就是一次真实冲突。
处理方式分三级。第一级是最后写入胜出,按修改时间取较新版本,简单但可能丢数据。第二级是字段级合并,以同步前的本地版本为基准,对标题、正文、标签分别比较,只有双方都改了同一个字段才算冲突,其余字段各自取新值。第三级是保留双版本:合并不了就把两个版本都存下来,在界面上标出冲突,让用户自己选一个保留。同步完成后更新本地最后同步时间,下一轮增量同步从这里继续。
四、照着验收的清单
看四组操作就够了:断网新建文字、图片和录音灵感,首页是否立即出现;恢复网络并登录,MySQL 里是否出现对应记录,媒体目录里是否出现对应文件;两台设备改同一条笔记的不同字段,同步后是否各自保留;改同一个字段制造冲突,App 是否明确提示而不是悄悄覆盖。
结语
本地优先不是“先写本地再说”,而是一套有顺序、有版本、有冲突策略的约定:端侧保证即时写入和本地可靠,队列保证同步顺序,服务端保证增量与版本判断,冲突保证不悄悄丢数据。同样的思路换到待办、日记和素材库上也一样:先让用户在本地把事情记下来,再让云端慢慢把事情对齐。
- 点赞
- 收藏
- 关注作者
评论(0)