React Native安卓端Firebase Messaging通知点击事件异常求助

使用React Native 0.71.4，结合@react-native-firebase/messaging（17.5.0）和react-native-push-notification（8.1.1）处理安卓纯数据推送时，前台接收正常，但存在以下问题：

• 从退出状态点击通知打开应用，messaging().getInitialNotification()始终返回null
• 从后台点击通知打开应用，messaging().onNotificationOpenedApp()从未触发

问题根源 #

核心问题出在react-native-push-notification的配置和通知处理逻辑：

1. invokeApp: false阻断事件传递：该配置会让点击通知时不唤起应用原生Intent，导致Firebase Messaging无法捕获通知打开事件，因此getInitialNotification和onNotificationOpenedApp无法获取到对应的remoteMessage。
2. 本地通知覆盖远程通知上下文：在onNotification回调中直接创建本地通知，原始远程通知数据未被正确关联到点击事件，Firebase无法识别点击的通知来源。

解决方案 #

1. 修正PushNotification配置

修改index.js中的PushNotification.configure，调整invokeApp参数并优化通知处理逻辑：

PushNotification.configure({
    onNotification: function (notification) {
        // 仅在前台时创建本地通知（后台通知由Firebase处理）
        if (notification.foreground) {
            PushNotification.localNotification({
                channelId: key,
                foreground: true,
                visibility: "public",
                allowWhileIdle: true,
                importance: Importance.HIGH,
                priority: Importance.HIGH,
                ignoreInForeground: false,
                invokeApp: true, // 改为true，确保点击唤起应用并传递事件
                largeIcon: "ic_launcher",
                title: notification.data.title,
                message: notification.data.body,
                userInfo: notification.data, // 传递原始数据，关联Firebase事件
            });
        }
        // 必须调用finish，避免Android重复触发通知
        notification.finish(PushNotificationIOS.FetchResult.NoData);
    },

    permissions: {
        alert: true,
        badge: true,
        sound: true,
    },
    popInitialNotification: true,
    requestPermissions: true,
});

2. 用Firebase处理后台通知显示

在index.js的setBackgroundMessageHandler中，使用Firebase原生API显示后台通知，确保点击事件能被正确捕获：

messaging().setBackgroundMessageHandler(async (remoteMessage) => {
    console.log("BackgroundHandler");
    await AsyncStorage.setItem(NEW_NOTIFICATION, "true");
    DeviceEventEmitter.emit("newNotification", true);

    // 用Firebase显示后台通知，确保事件关联
    await messaging().displayNotification({
        android: {
            channelId: key,
            priority: "high",
            importance: "high",
            largeIcon: "ic_launcher",
        },
        title: remoteMessage.data.title,
        body: remoteMessage.data.body,
        data: remoteMessage.data,
    });
});

3. 验证AndroidManifest.xml配置

检查android/app/src/main/AndroidManifest.xml是否包含Firebase Messaging必要服务：

<!-- Firebase Messaging核心服务 -->
<service
    android:name="io.invertase.firebase.messaging.RNFirebaseMessagingService"
    android:exported="false">
    <intent-filter>
        <action android:name="com.google.firebase.MESSAGING_EVENT" />
    </intent-filter>
</service>
<service
    android:name="io.invertase.firebase.messaging.RNFirebaseBackgroundMessagingService"
    android:exported="false" />

4. 确认App.tsx监听逻辑

保持App.tsx中的监听代码，可添加日志辅助调试：

useEffect(() => {
    checkNotificationPermission(); 

    const foreground = messaging().onMessage(async (remoteMessage) => {
        console.log("Foreground Notification: ", remoteMessage);
        generalStore.setNewNotificationAsync(true);
    });

    messaging()
        .getInitialNotification()
        .then(async (remoteMessage) => {
            console.log("Initial Notification: ", remoteMessage);
            if (remoteMessage) {
                // 处理退出状态打开的通知
            }
        });

    const background = messaging().onNotificationOpenedApp((remoteMessage) => {
        console.log("Opened from Background: ", remoteMessage);
        if (remoteMessage) {
            // 处理后台打开的通知
        }
    });

    return () => {
        foreground();
        background();
    };
}, []);

关键注意事项 #

• 纯数据通知在安卓后台/退出状态下，必须通过setBackgroundMessageHandler处理并显示，否则系统不会自动展示通知。
• 同时使用两个推送库时，避免重复处理通知，确保事件传递路径清晰。
• 测试时需完全退出应用（划掉后台进程），再发送通知点击测试，避免缓存干扰。

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