Flutter Web集成Hive刷新页面出现空白及TypeId错误求助

核心问题定位 #

报错HiveError: Cannot read, unknown typeId: 34说明刷新后Hive读取到了未注册typeId对应的数据，但当前代码里没有注册typeId=34的适配器。首次运行正常是因为当时存储的数据都是已注册类型，刷新后读取的IndexedDB里存在旧的、未适配的数据（大概率是之前开发测试时遗留的）。

具体排查与解决步骤 #

1. 清理旧的IndexedDB数据 #

Chrome中打开开发者工具（F12），进入Application标签 -> IndexedDB -> 找到Hive数据库，右键删除。重新运行应用，测试刷新是否正常。

这是最快速验证的方法，旧数据里的未知typeId是引发该问题的常见原因。

2. 调整初始化顺序 #

当前代码是注册一个适配器就打开对应Box，但若某个Box中包含其他自定义类型的数据，打开时该类型的适配器还未注册就会报错。建议调整为先注册所有适配器，再统一打开Box：

void main() async {
  WidgetsFlutterBinding.ensureInitialized();
  await Hive.initFlutter();

  // 先注册所有适配器
  Hive.registerAdapter<UserModel>(UserModelAdapter());
  Hive.registerAdapter<DocModel>(DocModelAdapter());
  Hive.registerAdapter<AuthorModel>(AuthorModelAdapter());
  Hive.registerAdapter<TopicModel>(TopicModelAdapter());
  Hive.registerAdapter<TypeModel>(TypeModelAdapter());

  // 再统一打开所有Box
  await Future.wait([
    Hive.openBox<UserModel>('user_model'),
    Hive.openBox<DocModel>('doc_model'),
    Hive.openBox<AuthorModel>('author_model'),
    Hive.openBox<TopicModel>('topic_model'),
    Hive.openBox<TypeModel>('type_model'),
  ]);

  runApp(const MyApp());
  SystemChrome.setPreferredOrientations([
    DeviceOrientation.landscapeRight,
    DeviceOrientation.landscapeLeft,
  ]);
}

3. 排查嵌套类型的适配器注册 #

检查所有模型的字段，是否存在嵌套的自定义类（比如某个模型里有List<CustomSubModel>这类字段），但未注册CustomSubModel的适配器。这类嵌套类型也需要生成适配器并注册，否则Hive无法解析。

4. 核对所有模型的typeId一致性 #

确认所有.dart模型文件中@HiveType(typeId: X)的数值，和对应的.g.dart适配器文件中typeId = X完全一致，且所有typeId唯一，无重复或遗漏。

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