如何通过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
相关产品推荐
相关产品推荐

