点击推送通知打开Flutter应用时启动页无图标显示空白

可能的原因 #

• 启动页资源加载优先级问题：从推送通知冷启动应用时，Flutter引擎的初始化流程和正常点击图标启动不同，启动页图标资源可能还没完成预加载就被渲染，导致显示空白。
• Firebase初始化阻塞UI线程：虽然你在main里异步初始化Firebase，但通知启动场景下，后台消息处理函数的初始化和主UI线程的资源加载可能存在竞争，挤占了启动页资源的加载时间。
• Android原生启动页配置遗漏：如果你的启动页是基于Android原生Splash Screen实现的，可能在通知启动的intent-filter里没有正确关联启动主题，导致系统没有加载对应的图标资源。

解决方案 #

1. 调整初始化顺序，预加载启动页资源 #

把启动页图标资源的预加载放在Firebase初始化之前，确保资源先准备好：

Future<void> main() async {
  WidgetsFlutterBinding.ensureInitialized();
  // 预加载启动页图标资源
  await precacheImage(const AssetImage('assets/splash_icon.png'), null);
  
  await Firebase.initializeApp(
    options: DefaultFirebaseOptions.currentPlatform,
  );
  FirebaseMessaging.onBackgroundMessage(_firebaseMessagingBackgroundHandler);
  
  runApp(const MyApp());
}

2. 检查Android原生启动页配置 #

确保AndroidManifest.xml中主Activity的所有intent-filter都关联了正确的启动主题，包括通知点击的入口：

<activity
    android:name=".MainActivity"
    android:exported="true"
    android:theme="@style/SplashTheme">
    <!-- 正常启动入口 -->
    <intent-filter>
        <action android:name="android.intent.action.MAIN"/>
        <category android:name="android.intent.category.LAUNCHER"/>
    </intent-filter>
    <!-- 通知点击启动入口 -->
    <intent-filter>
        <action android:name="FLUTTER_NOTIFICATION_CLICK"/>
        <category android:name="android.intent.category.DEFAULT"/>
    </intent-filter>
</activity>

同时确认res/values/styles.xml中的SplashTheme正确设置了启动页背景：

<style name="SplashTheme" parent="Theme.AppCompat.Light.NoActionBar">
    <item name="android:windowBackground">@drawable/splash_screen</item>
    <item name="android:windowFullscreen">true</item>
</style>

这里的@drawable/splash_screen是你定义的包含图标的layer-list资源文件。

3. 优化后台消息处理函数 #

后台处理函数只做必要的Firebase初始化，避免多余操作影响主进程：

@pragma('vm:entry-point')
Future<void> _firebaseMessagingBackgroundHandler(RemoteMessage remoteMessage) async {
  // 仅在Firebase未初始化时执行初始化
  if (Firebase.apps.isEmpty) {
    await Firebase.initializeApp(
      options: DefaultFirebaseOptions.currentPlatform,
    );
  }
  // 仅处理消息必要逻辑，比如记录日志
}

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