Flutter构建iOS调试版报Firebase.initializeApp channel-error错误

使用Flutter 2.10.2、Dart 2.16.1版本进行iOS调试构建时，代码执行到Firebase.initializeApp()环节抛出异常：

PlatformException Error (channel-error, Unable to establish connection on channel., null, null)
无法直接定位问题原因，当前项目pubspec.yaml中Firebase相关依赖配置如下：

firebase_core: 1.18.0
firebase_auth: 3.3.20
firebase_storage: 10.2.18
firebase_messaging : 11.4.2
cloud_firestore: 3.1.18
firebase_crashlytics: 2.8.2
firebase_dynamic_links: 4.2.6

1. 原生端配置校验 #

该错误本质是Flutter层调用Firebase初始化方法时，和iOS原生端的方法通道没有建立连接，首先排查原生配置遗漏：

• 确认GoogleService-Info.plist已正确导入iOS工程的Runner target，文件需加入编译资源列表，不能仅拷贝到工程目录未关联target。
• 检查AppDelegate文件中的初始化逻辑顺序：
  • Swift版本（ios/Runner/AppDelegate.swift）需在didFinishLaunchingWithOptions方法最顶部添加如下代码，且必须在GeneratedPluginRegistrant.register(with: self)之前执行：

    import Firebase
    // 方法内首行
    FirebaseApp.configure()
    

  • OC版本（ios/Runner/AppDelegate.m）对应代码如下，同样需要保证执行顺序：

    @import Firebase;
    // 方法内首行
    [FIRApp configure];
    

2. 构建缓存清理 #

当前使用的Flutter版本和列出的Firebase pub依赖本身不存在版本兼容问题，通道连接失败最常见的诱因是本地构建缓存损坏，按顺序执行以下命令清理重建：

# 清理Flutter层构建缓存
flutter clean

# 进入iOS目录清理pod依赖缓存
cd ios
pod deintegrate
pod cache clean --all
rm -f Podfile.lock

# M1芯片设备执行下一行命令安装依赖，非M1设备去掉前缀arch -x86_64
arch -x86_64 pod install --repo-update

# 返回项目根目录拉取Flutter依赖
cd ..
flutter pub get

清理完成后先卸载设备上已安装的旧调试包，再重新执行构建命令即可。

3. 特殊场景排查 #

如果上述操作后问题仍存在，逐一排查以下场景：

• 检查ios/Runner/Info.plist中是否将FirebaseAppDelegateProxyEnabled设为NO：如果没有手动实现Firebase相关的推送、动态链接代理逻辑，直接删除该配置项或将值改为YES。
• 检查项目中集成的其他原生插件、自定义Flutter插件是否重写了AppDelegate生命周期方法、拦截了方法通道注册逻辑，若有重写必须调用父类对应方法的实现。
• 打开Xcode检查Runner target的Build Phases > Link Binary With Libraries列表，确认Firebase相关原生库都已正确链接，没有出现红名缺失的情况。

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