Hive多Dart文件类适配器生成与统一注册问题

1. 统一生成适配器到单个.part文件 #

要把多个分散类的适配器生成到同一个.part文件，需要创建一个统一的注册表文件，让build_runner识别所有需要生成适配器的实体类：

• 创建一个文件（比如hive_registry.dart），内容如下：

import 'package:hive/hive.dart';
// 导入所有带@HiveType注解的实体类
import 'class_a.dart';
import 'class_b.dart';
import 'class_c.dart';

// 指定生成的适配器文件路径
part 'hive_registry.g.dart';

• 每个实体类保持独立的@HiveType和@HiveField配置，不需要额外的适配器注册代码，比如ClassA：

import 'package:hive/hive.dart';

@HiveType(typeId: 0) // 每个类的typeId必须全局唯一
class ClassA {
  @HiveField(0)
  String string = "";
}

ClassB同理：

import 'package:hive/hive.dart';

@HiveType(typeId: 1)
class ClassB {
  @HiveField(0)
  String string = "";
}

• 运行build_runner命令生成适配器：

flutter pub run build_runner build --delete-conflicting-outputs

执行后，所有类的适配器都会合并生成到hive_registry.g.dart文件中。

2. 正确注册适配器 #

不需要在每个类中单独写初始化方法，直接在项目主入口（main函数）统一注册所有适配器即可：

import 'package:hive/hive.dart';
import 'hive_registry.dart'; // 导入注册表文件，自动包含生成的适配器

void main() async {
  // 初始化Hive存储路径（移动端用initFlutter，桌面端用init）
  var path = "assets/";
  await Hive.initFlutter(path);

  // 批量注册所有适配器
  Hive
    ..registerAdapter(ClassAAdapter())
    ..registerAdapter(ClassBAdapter());

  // 打开目标Box，所有类都可以存入这个Box
  final myBox = await Hive.openBox('shared_box');
}

3. 常见问题排查 #

• 之前适配器未生成到.part文件：因为没有创建统一的注册表文件，build_runner无法识别需要将多个类的适配器合并生成到同一个文件。
• 必须保证每个实体类的typeId全局唯一，否则会导致存储、读取数据时出现错误。
• 运行build_runner时加上--delete-conflicting-outputs参数，可避免缓存导致的生成异常。

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