React Native中Firebase仅数据通知iOS接收异常排查求助

我们用React Native开发应用，计划切换为仅数据通知（基于notifee库）以获得更多通知控制权。用Postman调用Firebase HTTP协议发送带data对象的测试通知时，Android真机/模拟器、iOS真机均能正常接收；但通过自有系统触发通知时，Android可正常接收，iOS端Firebase的onMessage和setBackgroundMessageHandler始终不触发。

后台消息监听代码（index.js） #

import React from 'react';
import { AppRegistry } from 'react-native';
import messaging from '@react-native-firebase/messaging';
import App from './App';
import { name as appName } from './app.json';
import Providers from './src/Providers';

messaging().setBackgroundMessageHandler(async (remoteMessage) => {
  // Android端有日志，iOS端不会执行到此处
  console.log('remoteMessage in BG handler', remoteMessage);
  
  // ...处理接收到的仅数据消息
});

const AppRedux = () => (
  <Providers store={store}>
    <App />
  </Providers>
);

AppRegistry.registerComponent(appName, () => AppRedux);

export default AppRedux;

前台消息监听代码（useNotifications.tsx） #

import { useEffect } from 'react';
import messaging from '@react-native-firebase/messaging';
import { useNotificationPermission } from './useNotificationPermission';

export const usePushNotifications = () => {
  useNotificationPermission();
  
  const handleIncoming = async (remoteMessage: RemoteMessage) => {
    if (!remoteMessage) {
      // iOS端连此处都不会触发
      console.error('No remote message received');
      return;
    }

    // Android端触发，iOS端不触发
    console.log('=== INCOMING ===', remoteMessage);
    
    // ...处理消息
  };


  useEffect(() => {
    // 处理应用前台时的消息
    messaging().onMessage(handleIncoming);
  }, []);
};

服务器发送的消息负载 #

{
  "apns": {
    "payload": {
      "aps": {
        "content-available": 1
      }
    }
  },
  "data": {
    "notifee": {
      "data": {
        // 自定义数据
      },
      "title": "Hello",
      "body": "World citizens"
    }
  }
}

已知假设 #

• 后端发送逻辑无问题，Android端接收正常可佐证
• 消息已通过Firebase系统，能传递到Android设备
• 问题大概率出在APNS或iOS设备本身

待解决问题 #

1. 代码是否存在错误？
2. 发送的消息负载格式是否有误？
3. 能否查看APNS日志，确认通知是否被APNS拦截？

已尝试操作及预期 #

• 按Firebase规范将data对象内的所有项转为字符串，无效
• 在顶级负载中添加content-available: true，无效
• 附加APNS请求头，无效
• 预期：iOS设备能正常接收“静默”仅数据通知

问题排查与解决方案 #

1. 代码层面排查

• 前台订阅清理：messaging().onMessage返回取消订阅函数，当前useEffect未清理订阅（虽不直接导致收不到消息，但可能引发内存泄漏），修改如下：

  useEffect(() => {
    const unsubscribe = messaging().onMessage(handleIncoming);
    return unsubscribe; // 组件卸载时取消订阅
  }, []);
  

• 后台权限配置：iOS后台处理需开启Xcode中Capabilities > Background Modes > Remote notifications权限，确认已配置。setBackgroundMessageHandler的调用位置正确，确保无异步逻辑延迟该调用。

2. 消息负载格式修正

iOS静默通知有严格格式要求：

• 添加mutable-content字段：需在aps内加入该字段，否则APNS可能不唤醒应用处理消息，同时设置APNS优先级为5（静默通知专用）：

  "apns": {
    "payload": {
      "aps": {
        "content-available": 1,
        "mutable-content": 1
      }
    },
    "headers": {
      "apns-priority": "5"
    }
  }
  

• 检查数据大小：APNS对data字段总大小限制为4KB，超过会被丢弃，确认自定义数据未超限。
• 移除冗余字段：不要在顶级负载添加content-available，APNS仅识别aps内的该字段。

3. APNS日志查看方式

• iOS设备控制台：连接设备到Xcode，打开Window > Devices and Simulators > Open Console，搜索apsd（APNS守护进程）相关日志，可查看通知接收、处理的详细状态，包括拦截原因。
• Firebase控制台：在Cloud Messaging > Reports中查看消息发送状态，iOS消息若显示Failed/Dropped，会附带错误码（如InvalidPayload、DeviceTokenNotForTopic）。

额外注意事项

• iOS节流限制：iOS 13+对静默通知频率有严格限制，短时间内发送大量消息会被APNS节流，导致后续消息无法到达。
• notifee初始化时机：确保notifee在应用启动时完成初始化，后台处理消息时需调用notifee API显示通知，否则可能无法触发前台监听。

内容的提问来源于stack exchange，提问作者nburczyk-cs