鸿蒙灵感笔记的本地优先同步:先落库、再同步的三个关键取舍

举报
yd_239758213 发表于 2026/11/18 11:38:43 2026/11/18
【摘要】 灵感来得很快,消失得也很快。打开 App、点一下“+”、写两行字、拍一张图,这个动作如果还要等网络返回,用户就会放弃记录。鸿蒙灵感笔记案例的答案很直接:写操作先落本地,登录之后再同步到云端。落地要处理三个取舍:本地以什么为准、同步以什么为序、冲突以什么为准。 一、本地是唯一可信的写入入口端侧用 relationalStore 作为结构化数据的主数据源,图片和录音放在应用文件沙箱里。新建一条灵...

灵感来得很快,消失得也很快。打开 App、点一下“+”、写两行字、拍一张图,这个动作如果还要等网络返回,用户就会放弃记录。鸿蒙灵感笔记案例的答案很直接:写操作先落本地,登录之后再同步到云端。落地要处理三个取舍:本地以什么为准、同步以什么为序、冲突以什么为准。

一、本地是唯一可信的写入入口

端侧用 relationalStore 作为结构化数据的主数据源,图片和录音放在应用文件沙箱里。新建一条灵感时,App 先把标题、正文、类型、标签写进本地数据库,图片和录音先落盘、只把路径写进记录,界面随即刷新,全程不依赖网络。

这样做的好处是响应确定:离线、地铁、电梯里都能记。代价是本地必须足够可靠:写入要放在事务里,媒体先落盘再写记录,避免“记录有了、文件没了”;删除时先删记录再删文件,或用定时清理兜底。

二、同步队列决定了顺序,而不是网络决定

本地写完不等于同步完成。案例的做法是给每一次写操作留一条同步记录:操作类型是新增、修改还是删除,对应哪条笔记,内容快照是什么,时间戳是多少。登录拿到令牌后,后台任务按顺序消费队列表,逐条调用服务端接口;成功标记已同步,失败保留下来等下一次重试。

顺序比速度重要。同一条笔记先改标题、后改标签,如果两条记录乱序到达服务端,最终状态就可能倒退。所以队列要按时间戳和操作序号严格排序,服务端也要按版本接收。图片和录音单独处理:先传结构化数据,再传媒体,媒体失败只重试媒体。

服务端用 NestJS 提供接口,Prisma 把数据写进 MySQL,媒体文件保存到服务器受控目录。关键是两点:增量拉取接口按最后同步时间返回此后的变更,避免全量同步;单条写入接口带上客户端最后修改时间,让服务端判断写入是否过期。

三、冲突不要假装不存在,要分级处理

典型场景是:同一条笔记在手机上改了还没同步,在另一台设备上也改了并且已经同步到云端。第一台设备登录后推送时,客户端时间戳比服务端旧,内容又不一样,这就是一次真实冲突。

处理方式分三级。第一级是最后写入胜出,按修改时间取较新版本,简单但可能丢数据。第二级是字段级合并,以同步前的本地版本为基准,对标题、正文、标签分别比较,只有双方都改了同一个字段才算冲突,其余字段各自取新值。第三级是保留双版本:合并不了就把两个版本都存下来,在界面上标出冲突,让用户自己选一个保留。同步完成后更新本地最后同步时间,下一轮增量同步从这里继续。

四、照着验收的清单

看四组操作就够了:断网新建文字、图片和录音灵感,首页是否立即出现;恢复网络并登录,MySQL 里是否出现对应记录,媒体目录里是否出现对应文件;两台设备改同一条笔记的不同字段,同步后是否各自保留;改同一个字段制造冲突,App 是否明确提示而不是悄悄覆盖。

结语

本地优先不是“先写本地再说”,而是一套有顺序、有版本、有冲突策略的约定:端侧保证即时写入和本地可靠,队列保证同步顺序,服务端保证增量与版本判断,冲突保证不悄悄丢数据。同样的思路换到待办、日记和素材库上也一样:先让用户在本地把事情记下来,再让云端慢慢把事情对齐。

【声明】本内容来自华为云开发者社区博主,不代表华为云及华为云开发者社区的观点和立场。转载时必须标注文章的来源(华为云社区)、文章链接、文章作者等基本信息,否则作者和本社区有权追究责任。如果您发现本社区中有涉嫌抄袭的内容,欢迎发送邮件进行举报,并提供相关证据,一经查实,本社区将立刻删除涉嫌侵权内容,举报邮箱: cloudbbs@huaweicloud.com
  • 点赞
  • 收藏
  • 关注作者

评论(0)

0/1000
抱歉,系统识别当前为高风险访问,暂不支持该操作

全部回复

上滑加载中

设置昵称

在此一键设置昵称,即可参与社区互动!

*长度不超过10个汉字或20个英文字符,设置后3个月内不可修改。

*长度不超过10个汉字或20个英文字符,设置后3个月内不可修改。