FirebaseMessaging.getInitialMessage()返回null问题求助

针对应用处于关闭/终止状态时，FirebaseMessaging.instance.getInitialMessage()返回null的问题，可从以下几个方向排查修复：

1. 修正通知Payload结构 #

getInitialMessage()仅能捕获带通知内容的消息（纯数据消息在应用终止状态下点击无法触发该方法）。发送消息时需包含对应平台的通知字段：

• Android平台需包含notification字段：

{
  "notification": {
    "title": "测试标题",
    "body": "测试内容"
  },
  "data": {
    "target_page": "detail"
  },
  "to": "设备Token"
}

• iOS平台需包含aps字段：

{
  "aps": {
    "alert": {
      "title": "测试标题",
      "body": "测试内容"
    }
  },
  "data": {
    "target_page": "detail"
  },
  "to": "设备Token"
}

使用Firebase控制台发送时，选择「通知」标签页，不要选「纯数据」选项。

2. 配置AndroidManifest.xml #

在MainActivity的<activity>标签内添加intent-filter，确保点击通知能正确唤醒应用并传递消息：

<intent-filter>
  <action android:name="FLUTTER_NOTIFICATION_CLICK" />
  <category android:name="android.intent.category.DEFAULT" />
</intent-filter>

3. 显式请求通知权限 #

iOS和Android 13+需要显式请求通知权限，否则无法接收通知。在main函数中添加权限请求代码：

await FirebaseMessaging.instance.requestPermission(
  alert: true,
  badge: true,
  sound: true,
);

4. 提前监听初始消息 #

将getInitialMessage()的监听移至Firebase初始化完成后、runApp()之前，确保应用启动时第一时间捕获消息：

Future<void> main() async {
  WidgetsFlutterBinding.ensureInitialized();
  await Firebase.initializeApp();
  
  // 提前获取初始消息
  final initialMessage = await FirebaseMessaging.instance.getInitialMessage();
  if (initialMessage != null) {
    print('Initial message: $initialMessage');
    // 可将消息暂存，后续在页面中处理跳转逻辑
  }

  FirebaseMessaging.onBackgroundMessage(_firebaseMessagingBackgroundHandler);
  await FirebaseMessaging.instance.setForegroundNotificationPresentationOptions(
    alert: true,
    badge: true,
    sound: true,
  );

  runApp(const FrontDeskApp());
}

5. 更新Firebase插件版本 #

旧版本firebase_messaging可能存在已知bug，确保使用最新稳定版。在pubspec.yaml中更新依赖：

firebase_messaging: ^latest_version

6. 创建Android通知渠道（Android 8.0+） #

Android 8.0及以上系统必须创建通知渠道，否则通知无法正常显示：

if (Platform.isAndroid) {
  await FirebaseMessaging.instance.createNotificationChannel(
    AndroidNotificationChannel(
      'default_channel',
      '默认通知渠道',
      description: '用于接收所有应用通知',
      importance: Importance.high,
    ),
  );
}

内容的提问来源于stack exchange，提问作者Gaëtan GR