Flutter集成Firebase与Hive时初始化Hive报错，如何解决？

1. 修正初始化逻辑与重复调用问题 #

你的代码中重复调用了WidgetsFlutterBinding.ensureInitialized()，这会干扰插件的正常初始化流程。只需在main函数开头调用一次该方法，再统一执行异步初始化操作即可，调整后的代码如下：

void main() async {
  // 仅调用一次，放在所有异步操作之前
  WidgetsFlutterBinding.ensureInitialized();

  // 先完成Firebase初始化与服务注册，再初始化Hive
  await Firebase.initializeApp();
  GetIt.instance.registerSingleton<FirebaseService>(FirebaseService());

  await Hive.initFlutter("hive_boxes");

  runApp(const MyApp());
}

2. 重新构建项目以修复插件链接问题 #

MissingPluginException大多是插件未正确链接导致的，执行以下步骤解决：

• 停止当前运行的模拟器/真机进程
• 执行flutter clean清理项目缓存
• 执行flutter pub get重新拉取依赖
• iOS平台额外执行：cd ios && pod install && cd ..，之后再运行项目

3. 确认依赖配置正确性 #

Hive依赖path_provider获取文件目录，确保你的pubspec.yaml中已添加该依赖且版本适配：

dependencies:
  flutter:
    sdk: flutter
  hive: ^2.2.3
  hive_flutter: ^1.1.0
  path_provider: ^2.0.15
  firebase_core: ^2.15.0
  # 其他项目依赖...

添加后执行flutter pub get完成依赖安装。

4. 平台针对性检查 #

iOS平台 #

• 确认Xcode项目的Podfile中未禁用use_frameworks!（Firebase与Hive均依赖此配置）
• 打开Xcode执行Product > Clean Build Folder，之后重新构建项目

Android平台 #

• 检查android/app/build.gradle中的minSdkVersion不低于16（path_provider的最低要求）
• 确保Android Studio的Gradle同步完成，无构建报错

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