Flutter应用启动后卡在闪屏，无法进入主页面求助

问题核心定位 #

从终端报错日志可以确定，Firebase初始化失败是导致应用无法进入主页面的直接原因，报错信息PlatformException(null-error, Host platform returned null value for non-null return value.)表明Android端未正确读取Firebase的配置信息。

具体解决步骤 #

• 确认Google Services配置文件存在
  检查Android项目的android/app/目录下是否有google-services.json文件。该文件需从Firebase控制台下载，确保文件中的包名与你Flutter应用android/app/build.gradle里的applicationId完全一致。如果没有，登录Firebase控制台对应项目，进入「项目设置」→「添加Android应用」，填写正确信息后下载文件放入指定目录。

• 完善Firebase初始化代码
  若使用自定义Firebase配置，需在初始化时明确传入参数，示例代码：

  Future<void> main() async {
    WidgetsFlutterBinding.ensureInitialized();
    await Firebase.initializeApp(
      options: const FirebaseOptions(
        apiKey: "你的API_KEY",
        appId: "你的APP_ID",
        projectId: "你的PROJECT_ID",
        messagingSenderId: "你的SENDER_ID",
      ),
    );
    runApp(const MaterialApp(
      debugShowCheckedModeBanner: false,
      title: "Document Scanner",
      home: HomePage(),
    ));
  }
  

  若依赖google-services.json自动配置，确保文件路径和内容正确即可。

• 验证Android Gradle配置
  确认android/app/build.gradle文件末尾添加了以下代码，这是Gradle读取Firebase配置的必要步骤：

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

• 彻底清理并重构项目
  执行以下命令清理缓存并重新构建：

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

额外说明 #

终端中的闪屏警告属于旧版闪屏配置的提示，与当前启动卡住问题无关，可后续按需迁移，但不影响本次问题修复。

内容的提问来源于stack exchange，提问作者Mou Rani Biswas