首页
/ React Native Firebase 在 iOS 18 上的消息重复接收问题分析与解决方案

React Native Firebase 在 iOS 18 上的消息重复接收问题分析与解决方案

2025-05-19 20:39:44作者:虞亚竹Luna

问题现象

在使用 React Native Firebase 消息推送模块时,开发者发现在 iOS 18 系统上,onMessage 回调会被多次触发,导致同一消息被重复处理。这一问题在 iOS 17.5 及以下版本中不存在,仅出现在 iOS 18 设备上。

问题根源

经过开发者社区的深入讨论和分析,这个问题主要源于 iOS 18 系统本身的变更。在 iOS 18 中,系统会多次触发通知回调,特别是当应用处于前台时。具体表现为:

  1. 同一通知会被系统多次传递到应用层
  2. 每次传递的通知标识符(identifier)可能相同或仅有大小写差异
  3. 问题在 iOS 18.1 beta 版本中已被苹果修复

影响范围

  • 仅影响 iOS 18 系统设备
  • 影响所有使用 React Native Firebase 消息推送模块的应用
  • 主要出现在应用处于前台接收通知时

临时解决方案

在 iOS 18.1 正式版发布前,开发者可以采用以下几种临时解决方案:

方案一:消息 ID 去重

const lastMessageIdRef = useRef(null);

useEffect(() => {
  const unsubscribe = messaging().onMessage(async remoteMessage => {
    if (lastMessageIdRef.current === remoteMessage.messageId) return;
    
    lastMessageIdRef.current = remoteMessage.messageId;
    // 处理消息逻辑
  });

  return unsubscribe;
}, []);

方案二:原生层拦截

在 AppDelegate.m 中添加代码,通过比较通知标识符来过滤重复通知:

-(void)userNotificationCenter:(UNUserNotificationCenter *)center 
      willPresentNotification:(UNNotification *)notification 
        withCompletionHandler:(void (^)(UNNotificationPresentationOptions options))completionHandler 
{
  static NSString *lastNotificationId;
  
  if (![lastNotificationId isEqualToString:notification.request.identifier]) {
    // 处理新通知
    NSDictionary *userInfo = notification.request.content.userInfo;
    [RNCPushNotificationIOS didReceiveRemoteNotification:userInfo
                                  fetchCompletionHandler:^void (UIBackgroundFetchResult result){}];
  }
  
  lastNotificationId = notification.request.identifier;
  completionHandler(UNNotificationPresentationOptionSound | UNNotificationPresentationOptionAlert);
}

方案三:使用持久化存储

对于需要跨应用重启保持状态的场景,可以使用 MMKV 等持久化存储方案:

import { MMKV } from 'react-native-mmkv';

const storage = new MMKV({ id: 'notification-storage' });

messaging().onMessage(async message => {
  const messageId = message.messageId;
  const lastMessageId = storage.getString('lastMessageId');
  
  if (lastMessageId !== messageId) {
    storage.set('lastMessageId', messageId);
    // 处理新消息
  }
});

长期解决方案

随着 iOS 18.1 的发布,这个问题已在系统层面得到修复。建议开发者:

  1. 告知用户升级到 iOS 18.1 或更高版本
  2. 在应用中检测系统版本,仅对 iOS 18.0 应用临时解决方案
  3. 关注 React Native Firebase 官方更新,确保使用最新版本

最佳实践建议

  1. 消息处理逻辑应始终具备幂等性设计
  2. 重要业务逻辑不应仅依赖通知触发
  3. 考虑在服务端添加消息去重机制
  4. 对关键操作添加确认步骤,防止重复执行

总结

iOS 18 引入的消息重复问题给 React Native Firebase 开发者带来了挑战,但通过合理的临时解决方案和最终的系统修复,这个问题可以得到有效解决。开发者应根据自身应用特点选择合适的解决方案,并在系统更新后及时调整代码。

登录后查看全文
热门项目推荐

热门内容推荐

最新内容推荐

项目优选

收起
docsdocs
OpenHarmony documentation | OpenHarmony开发者文档
Dockerfile
149
1.95 K
kernelkernel
deepin linux kernel
C
22
6
openHiTLSopenHiTLS
旨在打造算法先进、性能卓越、高效敏捷、安全可靠的密码套件,通过轻量级、可剪裁的软件技术架构满足各行业不同场景的多样化要求,让密码技术应用更简单,同时探索后量子等先进算法创新实践,构建密码前沿技术底座!
C
980
395
ohos_react_nativeohos_react_native
React Native鸿蒙化仓库
C++
192
274
RuoYi-Vue3RuoYi-Vue3
🎉 (RuoYi)官方仓库 基于SpringBoot,Spring Security,JWT,Vue3 & Vite、Element Plus 的前后端分离权限管理系统
Vue
931
555
openGauss-serveropenGauss-server
openGauss kernel ~ openGauss is an open source relational database management system
C++
145
190
nop-entropynop-entropy
Nop Platform 2.0是基于可逆计算理论实现的采用面向语言编程范式的新一代低代码开发平台,包含基于全新原理从零开始研发的GraphQL引擎、ORM引擎、工作流引擎、报表引擎、规则引擎、批处理引引擎等完整设计。nop-entropy是它的后端部分,采用java语言实现,可选择集成Spring框架或者Quarkus框架。中小企业可以免费商用
Java
8
0
金融AI编程实战金融AI编程实战
为非计算机科班出身 (例如财经类高校金融学院) 同学量身定制,新手友好,让学生以亲身实践开源开发的方式,学会使用计算机自动化自己的科研/创新工作。案例以量化投资为主线,涉及 Bash、Python、SQL、BI、AI 等全技术栈,培养面向未来的数智化人才 (如数据工程师、数据分析师、数据科学家、数据决策者、量化投资人)。
Jupyter Notebook
75
66
openHiTLS-examplesopenHiTLS-examples
本仓将为广大高校开发者提供开源实践和创新开发平台,收集和展示openHiTLS示例代码及创新应用,欢迎大家投稿,让全世界看到您的精巧密码实现设计,也让更多人通过您的优秀成果,理解、喜爱上密码技术。
C
65
518
CangjieCommunityCangjieCommunity
为仓颉编程语言开发者打造活跃、开放、高质量的社区环境
Markdown
1.11 K
0