React Native中如何实现Firebase Cloud Messaging定时通知？

问题概述 #

在Firebase控制台的Cloud Messaging视图中，可创建定时测试通知并设置发送时间，但该功能没有公开API支持控制台外直接调用。你当前通过React Native客户端提交定时请求到Cloud Function，想确认是否能通过Cloud Functions + Admin SDK实现可靠的定时发送，以及是否有更优的替代方案。

你当前的实现代码 #

import messaging from '@react-native-firebase/messaging';
import { Alert } from 'react-native';

// 获取通知权限
export async function requestUserPermission() {
  const authStatus = await messaging().requestPermission();
  const enabled = 
    authStatus === messaging.AuthorizationStatus.AUTHORIZED ||
    authStatus === messaging.AuthorizationStatus.PROVISIONAL;

  if (enabled) {
    console.log('Authorization status:', authStatus);
  }
}

// 获取用户设置的时间并提交到后端
export async function scheduleNotification(hour, minute) {
  // 获取用户的FCM Token
  const token = await messaging().getToken();
  const now = new Date();  

  const futureTime = new Date(now.getTime() + (hour * 60 + minute) * 60000);

  // 发送请求到Cloud Function
  fetch('https://us-central1-firebase-mommy-notificationer.cloudfunctions.net/scheduleNotification', {
    method: 'POST',
    headers: {
      'Content-Type': 'application/json',
    },
    body: JSON.stringify({
      token: token,
      time: futureTime,
      message: "Breastfeeding Time!",
    }),
  })
    .then(response => {
      Alert.alert('通知已定时', `通知已成功定时。`);
    })
    .catch(error => {
      console.error('定时通知出错:', error);
    });
}

核心结论 #

FCM控制台的定时测试通知功能没有公开API，无法在控制台外直接调用。你当前的方案如果依赖Cloud Function内的延迟执行（如setTimeout），仅适合9分钟以内的短定时（Cloud Functions最长超时限制为9分钟），长定时场景下可靠性极低。

可靠的替代实现方案 #

1. Cloud Functions + Cloud Scheduler + Firestore（推荐） #

这是长定时场景下最稳定的方案，思路是将定时任务持久化存储，通过定时触发器定期检查并执行发送：

• 步骤1：客户端提交定时请求时，将FCM Token、发送时间、通知内容存入Firestore集合（如scheduledNotifications），标记为未发送。
• 步骤2：在Google Cloud控制台配置Cloud Scheduler，按需求设置触发频率（比如每分钟一次）。
• 步骤3：触发的Cloud Function查询Firestore中已到发送时间且未发送的任务，用Admin SDK发送FCM通知，发送完成后标记任务为已发送。

对应的Cloud Function代码示例

const functions = require('firebase-functions');
const admin = require('firebase-admin');
admin.initializeApp();

// 定时触发的通知发送函数（由Cloud Scheduler调用）
exports.sendScheduledNotifications = functions.pubsub.schedule('every 1 minutes').onRun(async (context) => {
  const now = new Date();
  // 查询符合条件的未发送任务
  const snapshot = await admin.firestore().collection('scheduledNotifications')
    .where('sendTime', '<=', now)
    .where('sent', '==', false)
    .get();

  const taskPromises = [];
  snapshot.forEach(doc => {
    const task = doc.data();
    // 构造FCM消息
    const fcmMessage = {
      token: task.token,
      notification: {
        title: '哺乳提醒',
        body: task.message
      }
    };
    // 执行发送并标记任务状态
    const sendPromise = admin.messaging().send(fcmMessage)
      .then(() => doc.ref.update({ sent: true }))
      .catch(err => {
        console.error('发送通知失败:', err);
        return Promise.reject(err);
      });
    taskPromises.push(sendPromise);
  });

  await Promise.all(taskPromises);
  return null;
});

// 接收客户端请求，保存定时任务到Firestore
exports.scheduleNotification = functions.https.onRequest(async (req, res) => {
  const { token, time, message } = req.body;
  if (!token || !time || !message) {
    return res.status(400).send('缺少必要参数');
  }

  try {
    const sendTime = new Date(time);
    await admin.firestore().collection('scheduledNotifications').add({
      token,
      sendTime,
      message,
      sent: false
    });
    return res.status(200).send('定时任务已创建');
  } catch (err) {
    console.error('创建定时任务失败:', err);
    return res.status(500).send('服务器错误');
  }
});

注意事项

• 需要在Google Cloud控制台配置Cloud Scheduler，选择Pub/Sub触发器并设置触发频率。
• Firestore需创建复合索引（针对sendTime和sent的查询条件），否则查询会失败。
• 可添加错误重试机制，对发送失败的任务标记重试次数，后续再次尝试发送。

2. 客户端本地定时（仅适合短时间非关键通知） #

使用React Native本地通知库（如react-native-push-notification）在客户端本地触发定时通知，但该方式局限性大：

• iOS中APP进入后台或被清理后，本地定时可能无法触发。
• Android中受厂商后台限制影响，部分系统会杀死后台进程，导致通知无法送达。

3. Cloud Functions延迟执行（仅适合9分钟内的短定时） #

如果定时时间在9分钟以内，可在Cloud Function中直接用setTimeout延迟发送，但该方式不稳定：

• Cloud Functions可能因资源回收提前终止，导致通知无法发送。
• 不适合需要持久化的定时任务。

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