文档开发者中心
我的
|

HarmonyOS 5

鸿蒙应用分布式数据同步如何实现跨设备一致性与冲突解决

已解决

在鸿蒙应用开发中,当多设备同时修改同一份数据时,如何实现跨设备数据一致性?遇到数据冲突时,有哪些推荐的解决策略和API使用建议?

点赞
收藏
1
回复
8
分享
举报
浏览127 发布于2026-09-04 02:10广西
全部评论
最多点赞
最新发布
最早发布
|
采纳答复

跨设备同步是异步、最终才达成一致的机制,不要当成跨设备强事务来用。传输和存数据交给系统处理;如果两边同时改同一条数据,到底保留哪份,还是得要自己做冲突判断。

  • 轻量配置用分布式 KV;结构化记录用 RDB 分布式表(setDistributedTables 后按需 sync)。同步完成后以本地库查询结果刷新 UI。
  • 每条记录至少保存:id、revision、updatedAt、deviceId、删除标记;写入用本地事务,重试保持幂等。
  • 简单字段可采用“版本号优先,deviceId 兜底”的确定性 LWW 策略;不要只依赖设备时间戳。
  • 表单/笔记等可按字段合并;协同文本应使用操作日志/CRDT,或由服务端串行裁决。
  • 删除使用墓碑标记并同步一段时间,避免离线旧副本重连后把已删除数据写回。
  • 支付、库存等强一致业务应以服务端为唯一权威,通过版本号/乐观锁处理冲突,不应只依赖端侧分布式同步。

官方资料:

3楼编辑于2026-09-04 02:41 来自广东
先为每条数据保存唯一 id、版本号和更新时间,所有写入都做幂等;同步时只传增量,不要直接整表覆盖。单人多设备场景可用“版本号 + 最后写入胜出”,重要字段按字段合并;多人协作则需要服务端乐观锁或 CRDT,并保留冲突副本让用户确认。HarmonyOS 的分布式数据能力负责传输/同步,业务冲突规则仍需自己定义。 
9楼回复于2026-09-04 08:08 来自四川

分布式 RDB/KV 的 sync() 负责可信设备间的数据传输和同步结果,不等于自动理解你的业务冲突。移动设备经常离线,通常只能按最终一致性设计;同一条记录被多端修改时,简单场景可接受最后写入胜出,但订单、余额、清单合并等不能只依赖时间戳。

建议每条记录至少保存 id、version、updatedAt、updatedBy、deleted,写入时使用事务和幂等操作;同步后发现 baseVersion 不一致就按字段合并、保留冲突副本或让用户选择。计数/集合类数据可用追加操作日志或 CRDT 思路,财务类数据则应以服务端权威流水为准。

另外要处理设备时钟漂移、删除墓碑、重复同步、离线重试和 schema 版本。先根据数据模型选择分布式 KV、关系型数据库或端云同步,再用两台设备同时离线修改同一记录做冲突测试,不能只验证“能同步过去”。

8楼回复于2026-09-04 07:08 来自四川
鸿蒙跨设备同步是“最终一致性”,不是强一致性。  
冲突一定会发生,系统不会替你解决,你必须自己设计策略。
一、鸿蒙跨设备同步的本质
官方明确说明:  
- 多设备同步是 异步 的  
- 只能保证 最终一致性  
- 不保证实时一致  
- 不提供强事务  
- 冲突需要开发者自己处理 
所以你必须把它当成“多副本同步系统”,而不是数据库事务。
二、不同数据库的冲突行为(非常关键)
1)分布式 KV(Single-Version / Multi-Device)
Single-Version(单版本)
- 多设备同时写同一个 key → 最新写入覆盖旧值  
- 不支持自定义冲突策略  
- 适合简单配置、状态同步  
Multi-Device(多设备协同)
- key 自动拼接 deviceId  
- 每个设备的数据隔离  
- 天然不会冲突  
- 但不能修改远端数据  
2)分布式 RDB(关系型数据库)
API 23+ 单版本表模式(推荐)
- 多设备写同一条记录会合并  
- 可通过 schema 指定“解冲突列”  
- 解冲突列必须 UNIQUE(如 uuid)  
- 系统根据解冲突列合并记录  
多设备协同表模式(旧模式)
- 数据按设备隔离  
- 不冲突  
- 不能修改远端数据  
三、跨设备一致性如何实现(工程实践)
1)数据模型必须包含这些字段
官方建议每条记录至少包含:  
- id(全局唯一)  
- revision(版本号)  
- updatedAt(更新时间)  
- deviceId(来源设备)  
- tombstone(删除标记)  
这些字段是你解决冲突的基础。
2)写入必须本地事务 + 幂等
- 每次写入必须可重试  
- 重试不会产生重复数据  
3)同步完成后必须重新查询本地库刷新 UI
不要依赖同步事件直接更新 UI  
四、冲突解决策略(实战可用)
方案 A:LWW(Last Write Wins)版本号优先
适用场景:简单字段(昵称、设置项)
规则:  
1. 比较 revision  
2. revision 相同 → 比较 deviceId(兜底)  
3. 版本高的覆盖低的  
官方建议不要只依赖时间戳,因为设备时间可能不准。  
方案 B:字段级合并(表单、笔记类)
适用场景:多字段对象
例如:  
- 标题按 LWW  
- 内容按 LWW  
- 标签按集合合并  
方案 C:操作日志 / CRDT(协同编辑)
适用场景:多人同时编辑文本、画布
官方建议:  
- 使用操作日志  
- 或使用 CRDT  
- 或由服务端串行裁决  
方案 D:墓碑删除(避免删除回滚)
删除不直接删记录,而是:  
- 设置 tombstone = true  
- 保留一段时间同步  
- 防止离线设备重连后把旧数据写回来  
方案 E:强一致业务必须走服务端
例如:  
- 支付  
- 库存  
- 订单  
必须以服务端为唯一权威,不能依赖端侧同步。  
五、API 使用建议(ArkTS 示例)
分布式 KV(Single-Version)示例
收起
自动换行
深色代码主题
复制
import { distributedKVStore } from '@kit.ArkData';
import { distributedDeviceManager } from '@kit.DistributedServiceKit';

let kvStore: distributedKVStore.SingleKVStore | undefined = undefined;

function createAndSync(context: Context): void {
  const config = { bundleName: 'com.example.demosync', context };
    const kvManager = distributedKVStore.createKVManager(config);

      const options = {
          createIfMissing: true,
              encrypt: true,
                  autoSync: false,
                      kvStoreType: distributedKVStore.KVStoreType.SINGLE_VERSION,
                          securityLevel: distributedKVStore.SecurityLevel.S3
                            };

                              kvManager.getKVStore<distributedKVStore.SingleKVStore>('syncStore', options, (err, store) => {
                                  if (err) return;
                                      kvStore = store;

                                          kvStore.put('user_name', 'Alice', () => triggerSync());
                                            });
                                            }

                                            function triggerSync(): void {
                                              if (!kvStore) return;

                                                const devManager = distributedDeviceManager.createDeviceManager('com.example.demosync');
                                                  const devices = devManager.getAvailableDeviceListSync();
                                                    const deviceIds = devices.map(d => d.networkId as string);

                                                      kvStore.sync(deviceIds, distributedKVStore.SyncMode.PUSH_PULL, 1000);
                                                      }

六、如何选型(最实用的决策树)

1)数据简单、字段少
→ 分布式 KV(Single-Version)  
→ 冲突用 LWW
2)数据结构复杂、有多字段
→ 分布式 RDB(单版本表模式)  
→ schema 配置解冲突列
3)每个设备数据独立
→ 多设备协同模式(KV 或 RDB)
4)协同编辑
→ CRDT / 操作日志 / 服务端裁决
5)强一致业务
→ 必须走服务端
最终总结
鸿蒙跨设备同步是最终一致性模型,冲突不可避免。  
你必须通过版本号、设备 ID、解冲突列、墓碑删除等方式自行解决冲突。  
KV 适合简单场景,RDB 单版本表适合复杂场景,强一致业务必须走服务端。
展开全部
7楼回复于2026-09-04 04:42 来自陕西
学习
6楼回复于2026-09-04 04:18 来自陕西

由于移动终端设备具有不常在线且无中心的特点,所以同应用跨设备数据同步仅支持最终一致性。
鸿蒙提供了3中数据形式的同步,每种同步机制不同,参考如下:
键值型数据库跨设备数据同步 (ArkTS)
    
键值型数据库不支持应用程序自定义冲突解决策略。API接口说明
关系型数据库跨设备数据同步 (ArkTS)
    单版本表模式使用需要配置schema文件,用以指定同步列以及指定解冲突列。
    同一张表不能同时配置为端端分布式表和端云分布式表,且不支持切换。
    同一数据库下所有端端分布式表必须为一种数据同步存储机制,且不支持切换。
    多设备协同表模式下不支持设置schema,默认不读取schema文件。
    API接口说明
分布式数据对象跨设备数据同步 (ArkTS)

    暂时只支持在通过跨设备Call调用实现多端协同的场景中使用分布式数据对象进行数据同步。
    API接口说明

同步和冲突解决策略经验参考《分布式数据同步模块常见问题及解决方案》
应用示例《社交通讯协同》


 

5楼编辑于2026-09-04 03:48 来自北京

鸿蒙同应用跨设备同步只支持最终一致性,没有强一致性。冲突解决取决于你选的数据库类型——键值型数据库不支持自定义冲突策略,系统按"最新写入覆盖"解决;关系型数据库从 API 23 开始支持单版本表模式,可通过 schema 配置解冲突列来控制合并行为。如果你完全不想处理冲突,用多设备协同模式,数据按设备隔离,天然不会冲突。

一致性模型

官方文档明确说了,因为移动终端设备不常在线且无中心节点,跨设备同步仅支持最终一致性——某个时间窗口之后组网内数据达到一致,但不保证实时一致。

相关文档:同应用跨设备数据同步概述

三种同步方案怎么选

按数据生命周期选:临时数据用分布式数据对象,持久数据用键值型或关系型数据库。

分布式数据对象适合跨端迁移和多端协同场景,数据存在内存里,通过 sessionId 自动同步,但只能在迁移和跨设备 Call 场景用,数据量限制 150KB-500KB。

键值型数据库读写性能好,冲突解决简单,适合不涉及复杂关系的场景(联系人、天气等)。

关系型数据库适合有复杂关联的持久数据(图库相册等),API 23 起支持单版本表模式做冲突合并。

冲突解决策略

键值型数据库两种模式下冲突处理不同:

单版本数据库——同一条记录多设备修改时,按时间戳最新保留一条,旧数据被覆盖,不支持自定义冲突解决策略。

多设备协同数据库——Key 前面拼接了 DeviceID,每个设备数据严格隔离,不会冲突,但也不支持修改远端同步过来的数据。

关系型数据库同样有两种模式:

多设备协同表模式(API 23 前默认)——各设备数据隔离存储,不冲突,不支持修改远端数据。

单版本表模式(API 23+)——同步数据直接写入本地表,支持修改远端数据,通过 sync_schema.json 配置解冲突列。解冲突列必须具有 UNIQUE 属性且类似 uuid 全局唯一,冲突时以解冲突列值相同的记录做合并。

相关文档:键值型数据库跨设备数据同步 | 关系型数据库跨设备数据同步

实战建议

如果你的业务能接受"最后修改者胜出",键值型单版本数据库最简单。如果需要更精细的冲突控制,用关系型数据库单版本表模式,在 schema 里指定解冲突列。如果业务本身每个设备产生独立数据(比如图库缩略图按设备分),直接用多设备协同模式避开冲突。

需要申请 ohos.permission.DISTRIBUTED_DATASYNC 权限,且首次启动要弹窗向用户申请授权。

键值型单版本同步示例

收起
自动换行
深色代码主题
复制
import { distributedKVStore } from '@kit.ArkData';
import { distributedDeviceManager } from '@kit.DistributedServiceKit';
import { BusinessError } from '@kit.BasicServicesKit';

let kvManager: distributedKVStore.KVManager | undefined = undefined;
let kvStore: distributedKVStore.SingleKVStore | undefined = undefined;

function createAndSync(context: Context): void {
  const config: distributedKVStore.KVManagerConfig = {
    bundleName: 'com.example.demosync',
    context: context
  };
  kvManager = distributedKVStore.createKVManager(config);

  const options: distributedKVStore.Options = {
    createIfMissing: true,
    encrypt: true,
    autoSync: false,
    kvStoreType: distributedKVStore.KVStoreType.SINGLE_VERSION,
    securityLevel: distributedKVStore.SecurityLevel.S3
  };

  kvManager.getKVStore<distributedKVStore.SingleKVStore>('syncStore', options,
    (err, store: distributedKVStore.SingleKVStore) => {
      if (err) { return; }
      kvStore = store;

      kvStore.on('dataChange', distributedKVStore.SubscribeType.SUBSCRIBE_TYPE_ALL,
        (data) => { console.info('Data changed: ' + JSON.stringify(data)); });

      kvStore.put('user_name', 'Alice', (err: BusinessError) => {
        if (err) { return; }
        triggerSync();
      });
    });
}

function triggerSync(): void {
  if (!kvStore) { return; }
  const devManager: distributedDeviceManager.DeviceManager =
    distributedDeviceManager.createDeviceManager('com.example.demosync');
  const devices = devManager.getAvailableDeviceListSync();
  const deviceIds: string[] = devices.map(d => d.networkId as string);
  if (deviceIds.length > 0) {
    kvStore.sync(deviceIds, distributedKVStore.SyncMode.PUSH_PULL, 1000);
  }
}

展开全部
4楼回复于2026-09-04 03:00 来自四川
1
2楼回复于2026-09-04 02:27 来自江苏
写回答
新增插入模板功能
一键使用模板,快速填写内容,轻松发帖~
知道了
  • 为了保障您的信息安全,请勿上传您的敏感个人信息(如您的密码等信息)和您的敏感资产信息(如关键源代码、签名私钥、调试安装包、业务日志等信息),且您需自行承担由此产生的信息泄露等安全风险。
  • 如您发布的内容为转载内容,请注明内容来源。

我要提问题

了解社区公约,与您携手共创和谐专业的开发者社区。