React Native Firebase iOS推送通知在开发/发布模式下失效求助

一、苹果开发者账号配置必查项 #

App ID（Identifiers） #

• 目标App ID必须启用Push Notifications功能
• App ID的Bundle ID要和项目Info.plist里的CFBundleIdentifier完全一致，大小写也不能错

APNs Authentication Key #

• 已在Keys板块生成有效的APNs Auth Key，类型选Apple Push Notification service (APNs)
• 生成Key时已关联当前开发者团队，且Key未被撤销
• 保存的.p8文件未被修改（包括换行符，原文件直接用）

Provisioning Profiles #

• 开发（Development）和发布（Distribution）模式的Profile都要包含Push Notifications权限
• Profile是基于上述正确配置的App ID生成的，且未过期
• 本地项目已正确导入对应Profile（Xcode的Signing & Capabilities里可确认）

二、项目与代码配置排查 #

1. Firebase控制台配置 #

• 已在Cloud Messaging板块上传正确的APNs Auth Key，填对对应的Key ID和Team ID
• Firebase里iOS应用的Bundle ID和项目完全一致

2. Xcode项目配置 #

• Signing & Capabilities中已添加Push Notifications capability，开发/发布环境都要勾选
• 开启Background Modes，并勾选Remote notifications（保证App后台能收通知）
• 如果手动配置而非通过Capability添加，要在Info.plist里加UIBackgroundModes数组，包含remote-notification项

3. React Native Firebase代码逻辑 #

• 应用启动时要正确请求通知权限：

  import messaging from '@react-native-firebase/messaging';
  
  const requestUserPermission = async () => {
    const authStatus = await messaging().requestPermission({
      alert: true,
      badge: true,
      sound: true,
    });
    const enabled =
      authStatus === messaging.AuthorizationStatus.AUTHORIZED ||
      authStatus === messaging.AuthorizationStatus.PROVISIONAL;
    if (enabled) {
      console.log('Authorization status:', authStatus);
    }
  };
  

• 确认能正确获取FCM令牌，且令牌不为空：

  const getFCMToken = async () => {
    const token = await messaging().getToken();
    if (token) {
      console.log('FCM Token:', token);
      // 上传到你的业务服务器
    }
  };
  

• 检查通知接收逻辑，messaging().onMessage（前台）和messaging().setBackgroundMessageHandler（后台）都要正确实现

4. 环境与依赖验证 #

• @react-native-firebase/app和@react-native-firebase/messaging版本确认为^17.3.2，且已成功执行pod install
• 开发模式选Xcode的Debug配置，发布模式选Release配置，对应的Provisioning Profile要匹配
• 测试发布模式时，要用Ad Hoc或App Store分发包，不能直接用Xcode运行的Debug包

三、常见问题排查 #

• 确认APNs环境：调试用开发环境，开发/发布模式下Firebase会自动切换到生产环境，若手动配置需注意端点
• 查看Xcode控制台日志：过滤APNs或FirebaseMessaging关键词，排查权限请求、令牌获取或通知接收的错误信息
• 服务器发送通知时，确保针对不同环境用了正确的FCM逻辑（Firebase默认自动处理，自定义发送需注意）

内容的提问来源于stack exchange，提问作者Deepak Sharma