如何在Hive对象中存储、更新HiveList类型的嵌套Hive对象列表

问题根因 #

你修改HiveList之后没有主动持久化所属的Model1实例，Hive不会自动监听HiveList的内部变更并同步到磁盘，因此你的修改仅停留在内存中，并未实际存储。

正确实现步骤 #

• 第一步：前置准备（必须先完成）
  确保你已经注册了两个模型的Adapter，并且提前打开对应的Box：

// 注册Adapter（通常在main方法中执行）
Hive.registerAdapter(Model1Adapter());
Hive.registerAdapter(Model2Adapter());

// 打开Box
final model1Box = await Hive.openBox<Model1>('model1_box');
final model2Box = await Hive.openBox<Model2>('model2_box');

• 第二步：初始化存储Model1实例
  你原来的初始化代码逻辑正确，补充非空处理的最佳实践如下：

// 初始化Model1时直接绑定model2Box的HiveList
await model1Box.add(Model1(
  id: counter,
  list: HiveList<Model2>(model2Box),
));

• 第三步：更新/插入Model2列表的正确操作
  添加完Model2实例到model2Box后，往HiveList添加元素后必须调用父对象Model1的save()方法持久化变更：

// 1. 创建并存储Model2实例
var _object = Model2(id: counter, name: 'Name $counter');
await model2Box.add(_object);

// 2. 取出要更新的Model1实例
final targetModel1 = model1Box.values.last;
// 3. 安全校验HiveList非空后添加元素
targetModel1.list?.add(_object);
// 4. 关键操作：主动保存Model1实例，将HiveList的变更同步到磁盘
await targetModel1.save();

如果是批量更新HiveList的场景，也可以直接替换整个列表后再保存：

final newModel2List = [model2Instance1, model2Instance2, model2Instance3];
targetModel1.list?.clear();
targetModel1.list?.addAll(newModel2List);
await targetModel1.save();

注意事项 #

• HiveList只能存储已经持久化到对应Box中的HiveObject实例，未提前存入对应Box的对象添加到HiveList会抛出异常。
• 如果删除了model2Box中的某个Model2实例，对应的HiveList会自动过滤掉已不存在的对象，不需要手动同步。

内容的提问来源于stack exchange，提问作者Santo Shakil