Flutter Firebase正式构建报错：未创建默认Firebase App

核心排查步骤 #

1. 确认Firebase初始化逻辑 #

• 确保在所有Firebase操作前调用Firebase.initializeApp()，建议放在main函数最开头，用async/await包裹，示例代码：

void main() async {
  WidgetsFlutterBinding.ensureInitialized();
  await Firebase.initializeApp(
    // 多环境/flavor场景下，需传入对应环境的配置参数
    options: DefaultFirebaseOptions.currentPlatform,
  );
  runApp(const MyApp());
}

• 检查是否存在分支逻辑导致release模式下初始化代码被跳过（比如误加了debug专属的条件判断）

2. 验证Flavor对应的Firebase配置文件 #

• 确认android/app/src/prod/google-services.json存在且配置正确（debug版本配置在src/debug目录，prod环境必须单独配置一份）
• 核对google-services.json中的package_name与prod flavor的applicationId完全匹配（查看app/build.gradle中prod flavor的配置）

3. 检查Gradle配置细节 #

• 确认app/build.gradle的最后一行添加了google-services插件，不要嵌套在flavor或buildType代码块内：

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

• 确保项目根目录的build.gradle中引入了正确版本的google-services依赖：

  buildscript {
    dependencies {
      classpath 'com.google.gms:google-services:4.4.1' // 使用最新稳定版本
    }
  }
  

• 检查prod flavor的release构建是否开启混淆导致Firebase代码被移除：
  在app/build.gradle的release块中配置混淆规则：

  buildTypes {
    release {
      minifyEnabled true
      proguardFiles getDefaultProguardFile('proguard-android-optimize.txt'), 'proguard-rules.pro'
    }
  }
  

  然后在proguard-rules.pro文件中添加Firebase相关的混淆豁免：

  -keep class com.google.firebase.** { *; }
  -keep class io.flutter.plugins.firebase.** { *; }
  

4. 彻底清理缓存后重新构建 #

• 执行以下命令清理所有构建缓存：

  flutter clean
  cd android && ./gradlew clean
  cd ..
  

• 重新构建并运行release版本：

  flutter run --release --flavor prod --verbose
  

5. 检查Firebase控制台配置 #

• 确认Firebase控制台中已添加prod flavor对应的应用，且applicationId与本地配置完全一致
• 检查是否开启了App Check等安全功能，导致release模式下未验证的请求被拦截（需为prod环境配置对应的验证方式）

内容的提问来源于stack exchange，提问作者Golam Sarwar Shakil