Flutter初始化Firebase抛出Unable to establish connection异常

问题场景 #

在Flutter项目中集成Firebase，main函数中按官方写法初始化时抛出通道连接失败异常，报错信息如下：

Unable to establish connection on channel.

对应初始化代码：

import 'package:flutter/material.dart';
import 'package:firebase_core/firebase_core.dart';
import 'firebase_options.dart';

Future<void> main() async {
  WidgetsFlutterBinding.ensureInitialized();
  await Firebase.initializeApp(
    options: DefaultFirebaseOptions.currentPlatform,
  );

  runApp(const MyApp());
}

按优先级依次排查修复 #

• 优先处理开发环境临时异常
  该错误最高发的场景是开发阶段热重载/热重启后触发，Flutter热重载不会重新初始化原生平台通道，直接停止当前调试进程，重新全量编译启动App即可，无需修改代码。
  如果重启后仍报错，执行清理命令重置项目缓存：

  flutter clean
  flutter pub get
  

• 校验Firebase配置文件正确性
  删除项目中已有的firebase_options.dart文件，重新在项目根目录执行flutterfire configure，选择正确的Firebase项目和需要支持的目标平台，重新生成配置文件，避免旧配置和平台不匹配。
  同时检查原生端配置文件位置：
  • Android端：确认google-services.json放在android/app目录下，没有放错目录层级
  • iOS端：确认GoogleService-Info.plist已通过Xcode添加到Runner工程的资源组中，仅把文件拷贝到ios/Runner目录但不关联工程引用会导致读取配置失败
• 校验原生工程配置
  Android端检查两个gradle文件的配置：
  1. 项目级android/build.gradle中已添加Google服务的classpath依赖
  2. App级android/app/build.gradle中已应用com.google.gms.google-services插件
     iOS端进入ios目录执行pod install --repo-update拉取最新的Firebase原生依赖，避免本地pod缓存版本和Flutter插件版本不匹配。
• 校验版本兼容性
  检查pubspec.yaml中firebase_core及其他Firebase系列插件版本，和本地安装的Flutter SDK版本是否适配，刚升级Flutter大版本后出现该问题时，将所有Firebase插件升级到对应支持的稳定版本即可。
• 多平台配置校验
  如果是在Web、Windows、macOS等非移动端平台运行报错，检查重新生成的firebase_options.dart中是否包含当前运行平台的配置项，flutterfire configure时未勾选对应平台会导致平台配置缺失，触发通道连接错误。

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