如何解决firebase_auth的PlatformException(channel-error,无法建立连接)错误？

问题现象 #

运行Flutter应用时抛出以下异常：

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

接入Firebase实现邮箱密码登录后，应用加载后直接显示空白白屏。

已尝试操作 #

• 执行flutter clean后重新flutter pub get安装依赖，问题未解决
• 执行flutter pub outdated确认无过期依赖
• 查阅相关问题但现有方案无效

相关代码片段 #

pubspec.yaml依赖部分 #

environment:
  sdk: ">=2.17.5 <3.0.0"

dependencies:
  flutter:
    sdk: flutter

  firebase_auth: ^3.4.2
  firebase_core: ^1.19.2

  provider: ^6.0.0

  cupertino_icons: ^1.0.2
  

dev_dependencies:
  flutter_test:
    sdk: flutter

  flutter_lints: ^2.0.0

flutter:
  uses-material-design: true

main.dart初始化代码 #

void main() async {
  WidgetsFlutterBinding.ensureInitialized();
  await Firebase.initializeApp(
    options: FirebaseOptions(
        apiKey: 'AIzaSyDywKRZf...',
        appId: '1:574402216485:android:f10c99e7142f...',
        messagingSenderId: '5744022...',
        projectId: 'receiptcamp'),
  );
  runApp(MyApp());
}

解决方案建议 #

• 校验Firebase配置参数：确认FirebaseOptions中的所有参数（apiKey、appId、projectId等）与Firebase控制台对应平台的配置完全一致，不要遗漏必填字段。
• 添加平台端配置文件：
  • Android：在android/app目录下放入从Firebase控制台下载的google-services.json
  • iOS：在ios/Runner目录下放入GoogleService-Info.plist
    添加后重新构建项目，确保配置文件被正确识别。
• 检查Android Gradle配置：
  1. 在android/build.gradle的依赖块中添加Google服务插件：

     dependencies {
       classpath 'com.google.gms:google-services:4.3.15' // 版本可按需调整
     }
     

  2. 在android/app/build.gradle末尾添加插件应用代码：

     apply plugin: 'com.google.gms.google-services'
     

• 捕获初始化异常定位问题：修改main函数，捕获Firebase初始化异常并输出详细信息，避免白屏同时便于排查：

  void main() async {
    WidgetsFlutterBinding.ensureInitialized();
    try {
      await Firebase.initializeApp(
        options: FirebaseOptions(
            apiKey: 'AIzaSyDywKRZf...',
            appId: '1:574402216485:android:f10c99e7142f...',
            messagingSenderId: '5744022...',
            projectId: 'receiptcamp'),
      );
      print("Firebase初始化成功");
      runApp(MyApp());
    } catch (e, stackTrace) {
      print("Firebase初始化失败: $e");
      print(stackTrace);
      runApp(MaterialApp(home: Scaffold(body: Text("初始化失败: $e"))));
    }
  }
  

• 彻底清理重建项目：执行以下命令彻底清理后重新构建：

  flutter clean
  rm -rf ios/Pods ios/Podfile.lock pubspec.lock
  flutter pub get
  cd ios && pod install && cd ..
  flutter run
  

• 升级Firebase依赖版本：尝试将firebase_core和firebase_auth升级到兼容当前Flutter版本的稳定版本，避免版本不兼容问题。

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