Flutter Android模拟器出现PlatformException(channel-error)问题求助

我的Flutter项目在iOS模拟器运行正常，但在Android Studio模拟器中启动时触发以下异常：

Unhandled Exception: PlatformException (channel-error, Unable to establish connection on channel., null, null)

错误栈指向Firebase.initializeApp()步骤。已尝试执行pub upgrade、更新Flutter及Firebase相关依赖，问题仍未解决。

项目配置信息 #

pubspec.yaml依赖 #

admob_flutter: ^3.0.0
firebase_auth: ^4.3.0
cloud_firestore: ^4.4.5
firebase_core: ^2.8.0
firebase_storage: ^11.0.16     
firebase_core_platform_interface: ^4.5.3

Project/build.gradle配置 #

buildscript {
    ext.kotlin_version = '1.8.0'
    repositories {
        google()
        mavenCentral()
    }

    dependencies {
        classpath 'com.android.tools.build:gradle:7.1.2'
        classpath "org.jetbrains.kotlin:kotlin-gradle-plugin:$kotlin_version"
        classpath 'com.google.gms:google-services:4.3.15'
    }
    allprojects {
      repositories {
        google()
        mavenCentral()
      }
    }

main.dart入口代码 #

Future<void> main() async {      
  WidgetsFlutterBinding.ensureInitialized();
  await Firebase.initializeApp(options: DefaultFirebaseOptions.currentPlatform);
  await FirebaseAuth.instance
      .setSettings(appVerificationDisabledForTesting: true);
  Admob.initialize();
  runApp(const MyApp());
}

可能的解决步骤 #

1. 检查Android端Firebase配置文件

确认android/app/google-services.json文件已正确添加，且内容与Firebase控制台中对应Android应用的配置完全一致。文件缺失或配置不匹配是通道连接失败的常见原因。

2. 适配Gradle版本兼容性

• 升级com.google.gms:google-services到最新稳定版（当前版本4.3.15可尝试升级至4.4.0+）
• 调整com.android.tools.build:gradle版本与Flutter SDK匹配，Flutter 3.x推荐使用7.4+版本，可修改为：

  classpath 'com.android.tools.build:gradle:7.4.2'
  

3. 验证AndroidManifest.xml配置

确保android/app/src/main/AndroidManifest.xml包含必要权限：

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

同时确认没有自定义Application类干扰Firebase初始化流程。

4. 清理缓存并重建项目

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

flutter clean
flutter pub get
cd android && ./gradlew clean build
cd .. && flutter run

5. 排查模拟器环境问题

• 确保模拟器系统版本不低于Android API 21（Firebase依赖最低要求）
• 尝试创建新的模拟器实例，排除现有模拟器的环境异常
• 确认模拟器已连接网络，Firebase初始化需要网络验证配置

6. 调整初始化顺序与异步逻辑

将Admob初始化移至Firebase完成之后，并添加await确保异步操作完成：

Future<void> main() async {      
  WidgetsFlutterBinding.ensureInitialized();
  await Firebase.initializeApp(options: DefaultFirebaseOptions.currentPlatform);
  await FirebaseAuth.instance
      .setSettings(appVerificationDisabledForTesting: true);
  await Admob.initialize();
  runApp(const MyApp());
}

7. 移除不必要的依赖声明

firebase_core_platform_interface属于firebase_core的内部依赖，直接声明可能导致版本冲突，建议从pubspec.yaml中移除该行：

# 删除此行
# firebase_core_platform_interface: ^4.5.3

内容的提问来源于stack exchange，提问作者서진형