Flutter运行App报Firebase未正确初始化错误，已配置仍失效

1. 校验 google-services.json 匹配性 #

• 打开你放在android/app/下的google-services.json，逐字核对文件内client.client_info.android_client.package_name字段的值，必须和app/build.gradle里的applicationId完全一致，差任意一个字符（比如大小写、后缀）都会导致配置读取失败。
• 确认文件存放路径绝对正确：直接放在android/app/目录下，不要错放到android/根目录、android/app/src/main/等其他位置。
• 如果你项目存在debug包单独的包名后缀（比如release包是com.xxx.app，debug包是com.xxx.app.debug），需要确认下载的google-services.json内包含对应debug包名的配置条目，否则debug构建时无法匹配到有效配置。

2. 修正Gradle插件的加载位置 #

• 你当前把apply plugin: 'com.google.gms.google-services'写在dependencies闭块的后方，这个执行时机不对，会导致插件无法在构建流程中注入Firebase配置。
• 正确的放置位置：将这行apply语句移到app/build.gradle文件的顶部，紧跟其他android、kotlin相关的apply plugin语句之后、android{}闭块之前，参考正确位置：

  // app/build.gradle 头部正确顺序
  apply plugin: 'com.android.application'
  apply plugin: 'kotlin-android'
  // 插件必须放在这个位置，所有配置块之前
  apply plugin: 'com.google.gms.google-services'
  
  android {
      // 原有android配置...
  }
  

3. 清除旧构建缓存 #

• 之前未添加google-services插件时生成的缓存配置会残留，仅执行flutter clean无法完全清除：
  • 手动删除项目下的android/.gradle文件夹、android/app/build文件夹、项目根目录下的build文件夹
  • 重新执行flutter pub get，再重新构建运行应用

4. 检查Dart层初始化逻辑 #

• 核对main函数中的Firebase初始化代码，必须满足两个要求：
  • 先执行WidgetsFlutterBinding.ensureInitialized()完成引擎绑定，再进行Firebase初始化
  • 对Firebase.initializeApp()添加await，确保初始化完成后再执行runApp，不要跳过异步等待直接启动应用
    参考正确初始化写法：

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

5. 版本兼容校验 #

• 你当前使用的firebase_core: ^1.0.3、firebase_auth: ^1.0.2是早期测试版，和当前配置的google-services:4.3.5存在一定兼容概率，如果上述步骤完成后问题仍存在，可以升级firebase相关依赖到稳定适配版本。

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