Firebase云函数文档创建触发时更新记录及FCM通知发送异常排查
现存实现的核心问题
- 云函数异步返回不规范:
onCreate回调未将完整的Promise链作为返回值传出,触发函数执行完成判定后会直接回收运行实例,新增FCM通知步骤后整体链路耗时变长,必然被提前终止执行。 - 快照读取逻辑错误:
onCreate触发传入的snap是文档创建时刻的只读快照,后续对文档的更新操作不会同步到这个snap中。原代码在执行完snap.ref.set()写入requestedFromId字段后,再从snap.data()读取这个字段,拿到的永远是undefined,导致通知发送时的目标用户id为空,直接触发FCM调用报错。 - FCM通知函数存在硬代码bug:
sendNotification内读取设备token时未调用.data(),直接从DocumentSnapshot对象取.token属性,得到的是undefined数组,触发fcm.sendToDevice报错。 - 异步链路上下文断档:传统Promise链中执行
doc.ref.set()操作后,返回值是Firestore写入操作的结果,之前步骤拿到的userProfile对象会被覆盖丢失,无法直接传递给通知函数。 - 错误可观测性缺失:
checkUserInFirebase无论成功失败都执行resolve,不会将异常抛出;最后.catch块仅返回错误对象、不输出日志,所有异常都会被无声吞掉,无法定位根因。 - 用户校验逻辑不严谨:当邮箱对应的Firebase用户不存在时,
checkUserInFirebase返回的结构里没有.user属性,会导致后续getUserProfile读取user.user.uid时直接抛出空引用错误。
调整后可正常运行的实现
代码改造核心是用async/await简化异步链路管理,修复所有硬代码bug,实现userProfile对象的全链路传递:
const functions = require("firebase-functions"); const admin = require("firebase-admin"); admin.initializeApp(); const db = admin.firestore(); const fcm = admin.messaging(); // 修正用户校验逻辑,错误直接抛出走统一捕获 async function checkUserInFirebase(email) { return await admin.auth().getUserByEmail(email) } async function getUserProfile(uid) { return db.collection("users").doc(uid).get(); } // 接收userProfile作为参数,不再从触发快照读取目标用户id async function sendNotification(userProfile, requesterName) { // 直接从userProfile取目标用户id,避免读快照拿不到刚写入的值 const targetUid = userProfile.id const querySnapshot = await db .collection('users') .doc(targetUid) .collection('tokens') .get(); // 修正token读取逻辑,从文档快照的数据层取 const tokens = querySnapshot.docs.map(snap => snap.data().token); const payload = { notification: { title: 'New Request!', body: `You received a new request from ${requesterName}`, icon: 'your-icon-url', click_action: 'FLUTTER_NOTIFICATION_CLICK' } }; // 过滤无效空token,避免FCM调用报错 const validTokens = tokens.filter(Boolean) if (!validTokens.length) return return fcm.sendToDevice(validTokens, payload); } exports.createRequest = functions.firestore .document('requests/{requestId}') .onCreate(async (snap, context) => { // 整个异步流程被云函数追踪,不会提前回收实例 try { const initialData = snap.data() const email = initialData.requestedFromEmail; const requesterName = initialData.requestedByName; const authUser = await checkUserInFirebase(email) const userProfile = await getUserProfile(authUser.uid) // 执行文档字段补全 await snap.ref.set({ requestedFromName: userProfile.data().fullName, requestedFromId: userProfile.id }, {merge:true}) // 直接把userProfile传给通知函数,无需从快照读值 await sendNotification(userProfile, requesterName) } catch (error) { // 输出结构化日志,所有异常可直接在云函数控制台排查 functions.logger.error('createRequest执行失败', error) } })
改造后的逻辑匹配点
- 全链路使用async/await后,
userProfile对象从获取开始就能在步骤间自由传递,不需要手动维护Promise上下文,也不会被中间操作的返回值覆盖。 - 通知的目标用户id直接从
userProfile中获取,避开了快照只读、拿不到刚写入字段的问题。 - 文档更新操作和通知发送顺序执行,保证文档字段补全完成后再发通知,逻辑一致性更强。
- 所有错误统一捕获并输出日志,不会出现异常被无声吞掉、无法定位的问题。
- 通知发送前过滤无效token,避免FCM接口因为空值、无效值抛错。
内容的提问来源于stack exchange,提问作者PowerMan2015
相关产品推荐
相关产品推荐

