使用Flutter连接Firebase时遭遇PlatformException通道连接错误

• 检查Firebase配置文件是否正确

  • Android端：把google-services.json放在android/app目录下，同时确认android/build.gradle里添加了classpath 'com.google.gms:google-services:4.4.0'（版本可按需更新），app/build.gradle底部要加apply plugin: 'com.google.gms.google-services'
  • iOS端：确保GoogleService-Info.plist已经添加到Xcode项目，并且勾选了"Copy items if needed"

• 验证Flutter与Firebase依赖版本兼容性

  • 对照Firebase官方文档的版本兼容说明，保证pubspec.yaml里的Firebase依赖版本和原生端Google服务版本匹配
  • 执行flutter pub upgrade更新依赖，再跑flutter clean清缓存，重新编译项目

• 规范Firebase初始化顺序

  • 必须在main()函数里先初始化Firebase再启动App，示例代码：

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

  • 别在Firebase初始化完成前调用任何Firebase相关API

• 检查原生端权限与配置

  • Android：确认android/app/src/main/AndroidManifest.xml里加了网络权限

    <uses-permission android:name="android.permission.INTERNET" />
    

  • iOS：检查Info.plist是否允许网络访问（默认是允许的，若有自定义ATS配置需核实）

• 清理重建项目

  • 依次执行以下命令：

    flutter clean
    rm -rf ios/Pods ios/Podfile.lock
    pod install --repo-update  # 仅iOS端执行
    flutter pub get
    flutter run
    

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