React Native应用退出状态下接收FCM推送无法触发闹钟如何解决？

问题根因 #

应用完全退出后，默认的FCM通知（notification）类型消息只会由系统托盘接收处理，不会唤醒应用进程执行自定义逻辑，只有高优先级的纯数据（data-only）类型FCM消息可以触发RN Firebase的后台消息回调，进而执行闹钟触发逻辑。

1. 调整FCM消息载荷格式 #

服务端下发FCM消息时必须使用纯数据类型，且设置高优先级，避免系统拦截：

{
  "to": "目标设备FCM Token",
  "data": {
    "type": "alarm_trigger",
    "alarm_title": "待办提醒",
    "alarm_content": "你设置的提醒已到时间"
  },
  "priority": "high",
  "android": {
    "priority": "high",
    "notification": null
  }
}

注意：不要在载荷中加入notification字段，否则应用退出时消息会被系统直接接管，不会走自定义回调。

2. 注册全局后台消息处理回调 #

在项目入口文件index.js中注册setBackgroundMessageHandler，该回调会在应用后台、完全退出状态下收到FCM数据消息时触发，配置必须放在应用注册逻辑之前：

import { AppRegistry } from 'react-native';
import messaging from '@react-native-firebase/messaging';
import ReactNativeAlarmNotification from 'react-native-alarm-notification';
import App from './App';

// 全局FCM后台/退出状态消息处理器
messaging().setBackgroundMessageHandler(async remoteMessage => {
  // 判断消息类型为闹钟触发指令
  if (remoteMessage.data?.type === 'alarm_trigger') {
    // 调用闹钟触发逻辑
    ReactNativeAlarmNotification.fireAlarm({
      title: remoteMessage.data.alarm_title,
      message: remoteMessage.data.alarm_content,
      channel_id: 'alarm_notify_channel',
      // 其余你需要的闹钟配置参数
    });
  }
});

AppRegistry.registerComponent('你的应用包名', () => App);

3. Android端额外适配 #

Android系统的权限限制会导致部分设备无法正常唤醒，需要做以下配置：

• 新增权限配置，在android/app/src/main/AndroidManifest.xml中添加以下权限：

<!-- FCM消息接收权限 -->
<uses-permission android:name="com.google.android.c2dm.permission.RECEIVE" />
<!-- 唤醒锁权限，避免处理消息时进程被杀死 -->
<uses-permission android:name="android.permission.WAKE_LOCK" />
<!-- 闹钟精确触发权限 -->
<uses-permission android:name="android.permission.SCHEDULE_EXACT_ALARM" />
<uses-permission android:name="android.permission.USE_EXACT_ALARM" />
<!-- 前台服务权限，高版本Android适配 -->
<uses-permission android:name="android.permission.FOREGROUND_SERVICE" />

• 国内Android厂商（小米、华为、OPPO、vivo等）需要引导用户手动开启自启动权限、后台活动权限，否则系统会拦截FCM消息的应用唤醒行为，可在应用首次启动时弹窗引导用户前往系统设置开启。
• 提前创建闹钟专属的通知渠道，Android 8.0及以上版本必须有合法通知渠道才能正常弹出闹钟通知和提示音。

4. 验证注意事项 #

• 测试时使用release包测试，debug模式下的热重载、异常崩溃逻辑会干扰后台回调的触发。
• 不要使用FCM官方控制台发送测试消息，控制台默认发送的是notification类型载荷，不会触发自定义回调，需通过自己的服务端下发纯数据类型消息。

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