You need to enable JavaScript to run this app. Firebase云函数文档创建触发时更新记录及FCM通知发送异常排查
优惠活动
大模型
产品
解决方案
定价
更多

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

相关产品推荐
方舟 Agent Plan

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

最近更新时间:2026.11.20 16:24:01