React Native Firebase 数据消息在 Android 后台接收问题解析

问题背景

在使用 React Native Firebase 消息推送功能时，开发者经常会遇到数据消息（data-only messages）在 Android 平台上无法在应用关闭状态下接收的问题。这是一个典型的跨平台推送通知实现挑战，特别是在结合使用 React Native Firebase 和 Notifee 库时。

核心问题分析

数据消息与通知消息的关键区别在于：

• 数据消息：仅包含自定义键值对数据，不自动显示通知
• 通知消息：包含预定义的标题和内容，系统会自动显示通知

在 Android 平台上，数据消息的后台接收依赖于以下几个关键因素：

1. 消息优先级设置：必须将 priority 设置为 "high"
2. 后台消息处理器：正确实现 setBackgroundMessageHandler
3. Android 清单配置：确保服务声明正确
4. 设备电源管理：不受厂商后台限制影响

技术解决方案

1. 消息负载配置

正确的 FCM 数据消息负载应包含高优先级标识：

{
  "data": {
    "customKey1": "value1",
    "customKey2": "value2"
  },
  "android": {
    "priority": "high"
  }
}

2. React Native 实现

在 React Native 端需要正确设置后台消息处理器：

import messaging from '@react-native-firebase/messaging';
import notifee from '@notifee/react-native';

// 设置后台消息处理器
messaging().setBackgroundMessageHandler(async remoteMessage => {
  if (!remoteMessage.notification) {
    try {
      await notifee.incrementBadgeCount();
      await handleBackgroundMessage(remoteMessage);
    } catch (error) {
      console.error("Error handling background message:", error);
    }
  }
  return Promise.resolve();
});

// 处理应用从关闭状态启动的情况
messaging().getInitialNotification()
  .then(remoteMessage => {
    if (remoteMessage) {
      console.log('App opened from quit state:', remoteMessage.data);
    }
  });

3. Android 清单配置

确保 AndroidManifest.xml 包含必要的服务声明（通常由 Gradle 自动合并）：

<service
  android:name="io.invertase.firebase.messaging.ReactNativeFirebaseMessagingService"
  android:exported="true"
  android:permission="com.google.android.c2dm.permission.SEND">
  <intent-filter>
    <action android:name="com.google.firebase.MESSAGING_EVENT"/>
  </intent-filter>
</service>

平台差异处理

针对不同平台的特性差异，建议采用以下策略：

1. Android 平台：

   • 数据消息通常可靠
   • 确保高优先级设置
   • 处理厂商后台限制

2. iOS 平台：

   • 数据消息可靠性较差
   • 考虑使用通知消息
   • 设置 content-available: true

最佳实践建议

1. 双轨消息策略：

   • 对 Android 使用数据消息
   • 对 iOS 使用通知消息

2. 错误处理：

   • 实现完善的错误日志记录
   • 考虑消息重试机制

3. 测试验证：

   • 在不同设备状态下测试（前台/后台/关闭）
   • 验证不同厂商设备的行为

总结

React Native Firebase 的数据消息功能在 Android 平台上通常可靠，但需要正确配置优先级和处理后台接收逻辑。对于关键业务通知，建议采用平台特定的消息策略，并充分测试在各种设备状态下的行为表现。理解平台差异和正确处理后台消息是构建可靠推送通知系统的关键。