Flutter项目Firebase在模拟器中无法运行的问题求助

核心问题 #

Flutter项目中Firebase在Web环境可正常运行，但Android模拟器中无法工作，编译时伴随废弃API提示，已执行基础清理升级操作但未解决。

排查与修复步骤 #

1. 先定位废弃API详情（消除干扰，精准排查） #

在android/app/build.gradle的android块中添加lint配置，执行编译时输出具体废弃API信息：

android {
    // 保留原有配置
    lintOptions {
        checkWarnings true
        warningsAsErrors false
    }
}

运行命令查看详细日志：

flutter build apk --debug -Xlint:deprecation

根据日志提示替换对应废弃API，避免编译警告掩盖核心故障。

2. 验证Firebase初始化状态 #

修改main.dart中的初始化代码，添加错误捕获，明确是否是初始化失败导致的问题：

void main() async {
  WidgetsFlutterBinding.ensureInitialized();
  SystemChrome.setSystemUIOverlayStyle(const SystemUiOverlayStyle(
    statusBarColor: Colors.transparent,
  ));
  try {
    await Firebase.initializeApp(
      options: DefaultFirebaseOptions.currentPlatform,
    );
    print("Firebase初始化成功");
  } catch (e) {
    print("Firebase初始化失败: $e");
  }
  bool isIntroPass = await HelperFunctions.getAppIntroduction();
  runApp(KampApp(isPassIntro: isIntroPass));
}

启动应用后查看控制台日志，确认初始化是否成功。

3. 核对Firebase配置细节 #

• SHA密钥一致性：执行./gradlew signingReport（Windows用gradlew.bat signingReport），获取debug版本的SHA-1密钥，确保和Firebase控制台添加的完全匹配，注意区分debug/release密钥。
• google-services.json有效性：确认文件放在android/app/目录下，是Firebase控制台对应Android应用下载的最新版本，无拼写或格式错误。
• 依赖版本兼容：
  • 升级google-services插件到最新稳定版，修改android/build.gradle：

    classpath 'com.google.gms:google-services:4.4.0'
    

  • 升级Kotlin版本到1.8.x适配最新依赖，修改android/build.gradle：

    ext.kotlin_version = '1.8.22'
    

4. 模拟器环境检查 #

• Google Play服务版本：打开模拟器设置→应用→Google Play服务，确保版本为最新，低版本会导致Firebase初始化失败。
• 网络连通性：验证模拟器能正常访问网络，可通过内置浏览器测试。
• 明文流量权限：若测试环境使用非HTTPS链接，在android/app/src/main/AndroidManifest.xml的<application>标签中添加：

  android:usesCleartextTraffic="true"
  

5. 彻底清理重建项目 #

执行以下命令清除缓存后重新构建：

flutter clean
rm -rf android/.gradle android/build
flutter pub get
flutter run

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