Android项目升级后Firebase Functions用FCM发推送报错如何解决
修复方案
核心问题梳理
- 异步操作未返回Promise:Firebase云函数要求所有异步操作必须返回Promise,否则函数会在操作完成前被强制终止,这是你的代码运行无效果的首要原因
- onUpdate触发器取值错误:onUpdate返回的第一个参数是
change对象,包含更新前的change.before和更新后的change.after两个文档快照,直接调用snapshot.data()无法获取正确数据 - Firestore路径拼接错误:查询路径中的
{docId}是触发器的占位符,不会在后续查询中自动替换,需要通过context.params.docId获取触发事件的文档ID手动拼接 - 多余的嵌套层级:你写的查询路径
Visitor/{docId}/{token}/{docId}不符合常规数据库结构,实际token要么是Visitor文档的直接字段,要么是Visitor文档下token子集合中的字段
修正后代码
如果token存放在Visitor文档下的token子集合中,修正后的代码如下:
exports.vsUp = functions.firestore.document("Visitor/{docId}").onUpdate( (change, context) => { // 获取更新后的Visitor文档数据 const updatedVisitor = change.after.data(); const docId = context.params.docId; // 正确拼接token子集合路径,返回Promise链 return admin.firestore().collection(`Visitor/${docId}/token`).get() .then(result => { const registrationTokens = []; result.docs.forEach(tokenDocument => { registrationTokens.push(tokenDocument.data().token); }); // 过滤空token,避免FCM报错 const validTokens = registrationTokens.filter(token => !!token); if (validTokens.length === 0) return null; // 返回FCM推送的Promise return admin.messaging().sendMulticast({ tokens: validTokens, notification: { title: updatedVisitor.visitor_name, body: updatedVisitor.visitor_status } }); }) .catch(err => { // 打印错误方便排查 console.error("推送失败:", err); return null; }); } );
如果token是Visitor文档的直接字段,不需要查询子集合,代码可以简化为:
exports.vsUp = functions.firestore.document("Visitor/{docId}").onUpdate( (change, context) => { const updatedVisitor = change.after.data(); const token = updatedVisitor.token; if (!token) return null; return admin.messaging().send({ token: token, notification: { title: updatedVisitor.visitor_name, body: updatedVisitor.visitor_status } }).catch(err => { console.error("推送失败:", err); return null; }); } );
排查建议
- 部署后可以在Firebase控制台的Functions日志页查看运行报错信息,快速定位问题
- 注意检查你的云函数是否已经开通了FCM和Firestore的访问权限,默认服务账号权限即可满足需求
内容的提问来源于stack exchange,提问作者neko12
相关产品推荐
相关产品推荐

