Flutter中Firebase实时数据库MissingPluginException错误修复求助

核心问题分析 #

MissingPluginException 通常意味着Flutter与原生平台的插件通道未正确建立，常见原因包括插件未安装、初始化逻辑冲突、缓存异常或平台配置缺失。

分步修复方法 #

1. 移除重复的Firebase初始化代码 #

你已经在main函数中通过await Firebase.initializeApp()完成了全局初始化，但在initState中又重复调用了未加await的Firebase.initializeApp()，这会导致初始化逻辑混乱。直接删掉initState中的冗余代码：

void initState() {
  super.initState();
  // 移除这行重复的初始化代码
  // Firebase.initializeApp();
  _checkFirstTime();
}

2. 确认Firebase Realtime Database插件已正确安装 #

• 打开pubspec.yaml，确保已添加对应依赖（替换为最新版本号）：

  dependencies:
    flutter:
      sdk: flutter
    firebase_core: ^2.20.0
    firebase_database: ^10.3.0
  

• 执行命令更新依赖：

  flutter pub get
  

3. 清理缓存并重建项目 #

插件通道异常常因缓存冲突导致，执行以下步骤彻底重建：

• 清理Flutter缓存：

  flutter clean
  

• 重新获取依赖：

  flutter pub get
  

• 卸载设备上的现有应用，重新运行项目：

  flutter run
  

4. 验证平台配置完整性 #

即使通过CLI关联了Firebase，仍需确认配置文件是否正确部署：

• Android：检查google-services.json是否放在android/app/目录下，且android/build.gradle、android/app/build.gradle中已配置Google Services插件（CLI关联通常自动完成，可核对确认）。
• iOS：通过Xcode确认GoogleService-Info.plist已添加到Runner目标中（需右键添加至项目，而非仅复制文件到目录）。

5. 临时验证数据库规则（可选） #

若上述步骤完成后仍有问题，可临时将Firebase Realtime Database的安全规则设为允许读写（仅用于测试，上线前需修改为安全规则）：

{
  "rules": {
    ".read": true,
    ".write": true
  }
}

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