You need to enable JavaScript to run this app. 如何通过Firebase Cloud Functions发送带OS专属配置的多目标FCM推送?
优惠活动
大模型
产品
解决方案
定价
更多

如何通过Firebase Cloud Functions发送带OS专属配置的多目标FCM推送?

问题核心原因

  • admin.messaging().send() 仅支持单设备推送,要求token参数传入单个字符串格式的设备令牌,你当前传入的是嵌套二维数组[tokens2](tokens2本身已是从Firestore中取出的令牌数组,外层额外包了数组括号),完全不符合参数要求。
  • 多设备批量推送需使用sendEachForMulticast(新版Firebase Admin SDK推荐,替代旧版sendMulticast)方法,该方法原生支持多令牌批量发送,同时完整保留安卓、iOS专属参数配置能力。

修复后的完整代码示例

const admin = require('firebase-admin');
// 若云函数模板未自带初始化,需自行完成初始化
// admin.initializeApp();

async function sendBatchPush(uid, title, content) {
  // 读取用户设备令牌
  const userDoc = await admin.firestore().doc(`Users/${uid}`).get();
  if (!userDoc.exists) {
    console.log('目标用户文档不存在');
    return;
  }
  const tokens = userDoc.data().tokens || [];
  if (tokens.length === 0) {
    console.log('无有效设备令牌,跳过推送');
    return;
  }

  // 构造多播消息体
  const multicastMessage = {
    notification: {
      title: title,
      body: content
    },
    data: {
      channel_id: "some_channel"
    },
    android: {
      notification: {
        notificationCount: 1
      }
    },
    apns: {
      payload: {
        aps: {
          badge: 42,
          sound: "default"
        }
      }
    },
    // 注意参数名为tokens,直接传入数组即可,无需额外嵌套
    tokens: tokens
  };

  try {
    // 执行多播推送
    const sendResult = await admin.messaging().sendEachForMulticast(multicastMessage);
    console.log(`推送执行完成:成功${sendResult.successCount}条,失败${sendResult.failureCount}条`);

    // 可选:清理无效/过期令牌,避免后续重复发送失败
    const invalidTokens = [];
    sendResult.responses.forEach((resp, index) => {
      if (!resp.success) {
        const errCode = resp.error.code;
        // 匹配无效令牌错误码,可按需扩展
        if (['messaging/invalid-registration-token', 'messaging/registration-token-not-registered'].includes(errCode)) {
          invalidTokens.push(tokens[index]);
        }
        console.log(`令牌${tokens[index]}发送失败,错误码:${errCode}`);
      }
    });

    // 从Firestore中移除无效令牌
    if (invalidTokens.length > 0) {
      await admin.firestore().doc(`Users/${uid}`).update({
        tokens: admin.firestore.FieldValue.arrayRemove(...invalidTokens)
      });
    }

    return sendResult;
  } catch (e) {
    console.error('推送整体调用失败:', e);
  }
}

注意事项

  • 若你使用的Firebase Admin SDK版本低于v11,没有sendEachForMulticast方法,直接替换为旧版sendMulticast方法即可,参数结构完全兼容。
  • FCM多播推送单次最多支持500个令牌,若单用户令牌数量超过500,需自行拆分为多个批次发送。

内容的提问来源于stack exchange,提问作者Rafael Zablah

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.10.16 14:54:05