Flutter Hive Adapter注册异常求助：无法写入未知类型()=>Null

常见排查点及修复方案 #

• 检查自定义类的Hive注解是否正确
  确保ReagentModel类顶部添加了@HiveType(typeId: 唯一数字)注解，且每个需要持久化的字段都用@HiveField(索引值)标记，索引不能重复，可选字段也不能遗漏注解。示例：

  @HiveType(typeId: 0)
  class ReagentModel extends HiveObject {
    @HiveField(0)
    final String name;
    
    @HiveField(1)
    int? count;
  
    ReagentModel({required this.name, this.count});
  }
  

• 确认Adapter注册时机正确
  main函数中必须严格遵循「初始化Hive → 注册Adapter → 打开Box」的顺序，不能颠倒。示例：

  void main() async {
    WidgetsFlutterBinding.ensureInitialized();
    await Hive.initFlutter();
    Hive.registerAdapter(ReagentModelAdapter());
    await Hive.openBox<ReagentModel>('reagents_box');
    runApp(const MyApp());
  }
  

• 重新生成Adapter文件
  删除旧的生成文件，运行flutter packages pub run build_runner build重新生成。若生成过程有缓存问题，可加--delete-conflicting-outputs参数强制清理后再生成。

• 排查保存对象的参数合法性
  报错中的() => Null通常是因为传入的ReagentModel实例包含未正确处理的空回调或非法类型字段。检查保存函数，确保传入的对象所有带@HiveField的字段都是合法数据类型，而非函数或未初始化的异常值。示例正确保存逻辑：

  Future<void> saveReagent(ReagentModel reagent) async {
    final box = Boxes.getReagents();
    await box.add(reagent);
  }
  

• 验证Boxes类的类型约束
  确保Boxes类中获取Box的方法指定了正确的泛型类型，避免类型不匹配：

  class Boxes {
    static Box<ReagentModel> getReagents() => Hive.box<ReagentModel>('reagents_box');
  }
  

额外注意事项 #

• 自定义类必须继承HiveObject（或手动实现TypeAdapter，推荐注解生成方式）。
• 多个自定义类的typeId必须唯一，不能重复。

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