React Native Firebase 中 iOS 平台 FCM onMessage 重复触发问题解析

问题现象

在使用 React Native Firebase 的 FCM (Firebase Cloud Messaging) 模块时，开发者报告了一个 iOS 平台特有的问题：当应用处于后台状态时收到通知，随后将应用切换到前台时，onMessage 监听器会被意外触发，导致通知重复显示。这个问题在 Android 平台上表现正常。

技术背景

FCM 提供了两种主要的消息处理方式：

1. 后台消息处理：当应用处于后台或关闭状态时，系统会自动处理通知显示
2. 前台消息处理：通过 onMessage 监听器处理应用在前台时收到的消息

在 iOS 平台上，消息处理机制与 Android 有所不同，特别是在处理 content-available 和 mutable-content 这些特殊标记时。

问题根源分析

通过对问题报告的深入分析，发现问题的根源在于通知负载中的特定配置：

"apns": {
  "payload": {
    "aps": {
      "content-available": 1,
      "mutable-content": 1,  // 这是导致问题的关键配置
      "sound": {
        "critical": true,
        "name": "default",
        "volume": 1.0
      }
    }
  }
}

mutable-content: 1 这个标记原本用于允许通知在显示前被修改（例如添加图片或视频），但在 React Native Firebase 的实现中，它会导致系统在应用从后台切换到前台时重新触发 onMessage 监听器。

解决方案

要解决这个问题，开发者可以采取以下两种方法之一：

1. 移除 mutable-content 标记： 这是最简单的解决方案，如果不需要修改通知内容，可以直接从 APNs 负载中移除这个标记。

   "apns": {
     "payload": {
       "aps": {
         "content-available": 1,
         // 移除 mutable-content 标记
         "sound": {
           "critical": true,
           "name": "default",
           "volume": 1.0
         }
       }
     }
   }
   

2. 在客户端添加处理逻辑： 如果需要保留 mutable-content 功能，可以在客户端添加额外的逻辑来防止重复显示：

   useEffect(() => {
     const unsubscribe = messaging().onMessage(async (remoteMessage) => {
       // 检查应用是否在前台
       const appState = AppState.currentState;
       if (appState === 'active') {
         Alert.alert("Hello");
       }
     });
     return unsubscribe;
   }, []);
   

最佳实践建议

1. 明确区分通知类型：根据实际需求决定是否需要使用 mutable-content 功能
2. 测试不同应用状态：在开发阶段充分测试应用在前台、后台和关闭状态下的通知行为
3. 版本兼容性检查：注意不同 React Native Firebase 版本在处理通知时的差异
4. 错误处理：在 onMessage 监听器中添加适当的错误处理逻辑

总结

React Native Firebase 的 FCM 模块在 iOS 平台上处理通知时，mutable-content 标记可能会导致 onMessage 监听器在应用状态变化时被意外触发。通过理解 iOS 通知处理机制和合理配置通知负载，开发者可以避免这类问题的发生，确保应用的通知功能在不同平台上表现一致。