Flutter应用添加Firebase.initializeApp后显示空白屏问题

核心问题 #

添加Firebase.initializeApp()后Flutter项目启动显示无报错空白屏，移除该代码则触发「Firebase No App」错误，已尝试常规清理/升级操作无效。

排查与修复步骤 #

1. 给Firebase初始化添加异常捕获 #

当前main函数未处理初始化的异常，可能存在静默失败导致后续流程卡住。修改代码如下：

Future<void> main() async {
  WidgetsFlutterBinding.ensureInitialized();
  try {
    await Firebase.initializeApp();
    print("Firebase初始化成功");
  } catch (e) {
    print("Firebase初始化失败: $e");
  }
  SystemChrome.setPreferredOrientations(
      [DeviceOrientation.portraitUp, DeviceOrientation.portraitDown]);
  initNotifications();
  runApp(MyApp());
}

运行后查看控制台输出，确认初始化是否存在具体错误信息。

2. 验证Firebase配置文件正确性 #

• Android端：检查android/app/google-services.json路径是否正确，文件内package_name需与项目applicationId完全一致。
• iOS端：确认ios/Runner/GoogleService-Info.plist已正确添加，BUNDLE_IDENTIFIER需匹配项目Bundle ID。
  配置文件不匹配会导致初始化静默失败，进而卡住启动流程。

3. 检查依赖版本兼容性 #

查看pubspec.yaml中Firebase相关依赖版本，确保与当前Flutter SDK兼容。可尝试锁定稳定版本：

firebase_core: ^2.24.2
# 其他Firebase依赖同步使用对应兼容版本

执行flutter pub get后重新运行项目。

4. 排查initNotifications()是否阻塞流程 #

暂时注释掉initNotifications()方法，若项目能正常启动，说明该方法内部存在阻塞问题，需进一步排查通知初始化逻辑。

5. 补全MultiProvider配置 #

原代码中MultiProvider缺少providers参数，这是错误写法，会导致Provider无法正常注入，可能引发空白屏。补全配置：

return MultiProvider(
  providers: [
    Provider<AuthBase>(create: (context) => Auth()),
    // 按需添加其他Provider
  ],
  child: MaterialApp(
    // 原有配置内容
  ),
);

6. 检查原生项目集成配置 #

• Android：确保android/build.gradle中添加Google服务插件：

buildscript {
  dependencies {
    classpath 'com.google.gms:google-services:4.4.0'
  }
}

并在android/app/build.gradle末尾添加：

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

• iOS：确认Podfile配置正确，执行pod install后重新编译项目。

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