Flutter调用Firebase.initializeApp()报无法建立通道连接错误如何解决

问题复现 #

接入2022年7月更新的正式版Firebase服务时，在main函数中调用初始化方法抛出如下错误：

'[ERROR:flutter/lib/ui/ui_dart_state.cc(198)] Unhandled Exception: PlatformException(channel-error, Unable to establish connection on channel., null, null)'

问题代码片段：

void main() async {
  WidgetsFlutterBinding.ensureInitialized();
  Firebase.initializeApp();
  runApp(const MyApp());
}

修复步骤 #

按优先级依次排查处理：

• 缺失异步等待：Firebase.initializeApp()是异步返回Future的方法，未加await会导致原生方法通道还未建立连接就执行后续逻辑，直接触发通道连接错误。先将初始化代码修改为：

  void main() async {
    WidgetsFlutterBinding.ensureInitialized();
    // 必须等待初始化完成再执行后续逻辑
    await Firebase.initializeApp();
    runApp(const MyApp());
  }
  

  修改后重新运行，若仍报错继续排查后续项。
• 原生端配置缺失：
  • Android侧：确认google-services.json文件已放置在android/app目录下，项目根级build.gradle已配置谷歌服务依赖，app级build.gradle已应用谷歌服务插件。
  • iOS侧：确认GoogleService-Info.plist已通过Xcode导入Runner项目，导入时勾选Copy items if needed，且已在ios目录下执行pod install完成原生依赖安装。
• 版本兼容与缓存问题：
  该版本FlutterFire要求Flutter SDK最低3.0、Dart最低2.17，先执行flutter doctor确认环境版本符合要求。之后执行以下命令清理构建缓存、重新拉取依赖：

  flutter clean
  flutter pub get
  

  Android额外执行：进入android目录运行./gradlew clean清理原生构建缓存；iOS额外执行：进入ios目录运行pod repo update后重新执行pod install，再重新编译运行。
• 初始化参数缺失：如果是通过flutterfire configure自动生成的配置，必须在初始化时传入对应平台的options参数，空参数调用在部分版本中会直接触发通道错误，正确写法如下：

  import 'firebase_options.dart';
  
  void main() async {
    WidgetsFlutterBinding.ensureInitialized();
    await Firebase.initializeApp(
      options: DefaultFirebaseOptions.currentPlatform,
    );
    runApp(const MyApp());
  }
  

• 依赖冲突排查：以上步骤都无效时，执行flutter run --verbose查看完整构建日志，排查是否存在其他第三方插件依赖的Firebase原生SDK版本与当前FlutterFire绑定的版本不兼容，统一升级所有依赖到兼容版本即可。

内容的提问来源于stack exchange，提问作者It's Guardian Time