Firestore云函数返回结果不一致问题排查求助

看来你正在搭建一个基于Firebase的团队通知系统，我来帮你把这个Cloud Function的实现梳理清楚，先补全核心逻辑的完整代码，再拆解关键要点：

完整可运行代码示例 #

const functions = require('firebase-functions');
const admin = require('firebase-admin');

// 初始化Firebase Admin SDK（注意配置键是小写的firebase，避免读取失败）
admin.initializeApp(functions.config().firebase);
const db = admin.firestore();

exports.newMemberNotification = functions.firestore
  .document('Teams/{teamId}/Waitlist/{userId}')
  .onDelete(async (snap, context) => {
    // 获取被删除的等待列表条目数据
    const waitlistEntry = snap.data();
    // 从触发路径中提取团队ID和用户ID
    const { teamId, userId } = context.params;

    try {
      // 步骤1：从Firestore获取团队信息和用户的FCM令牌
      const [teamDoc, userDoc] = await Promise.all([
        db.collection('Teams').doc(teamId).get(),
        db.collection('Users').doc(userId).get()
      ]);

      // 检查文档是否存在，避免无效操作
      if (!teamDoc.exists || !userDoc.exists) {
        console.log('团队或用户文档不存在，跳过通知发送');
        return null;
      }

      const teamData = teamDoc.data();
      const userData = userDoc.data();
      const userFcmToken = userData.fcmToken;

      // 步骤2：构建FCM通知内容
      const notificationPayload = {
        notification: {
          title: `🎉 已加入团队 ${teamData.teamName}`,
          body: '你已通过等待列表审核，正式加入团队啦！',
          sound: 'default'
        },
        token: userFcmToken
      };

      // 步骤3：调用Cloud Messaging发送通知
      await admin.messaging().send(notificationPayload);
      console.log(`已向用户${userId}发送加入团队通知`);
      return null;
    } catch (error) {
      console.error('发送通知时出现错误:', error);
      return null;
    }
  });

核心逻辑拆解 #

• 触发机制：这个函数是Firestore的onDelete触发器，当Teams/{teamId}/Waitlist/{userId}路径下的文档被删除时（比如用户从等待列表转为正式成员时删除等待条目），函数自动触发执行。
• Admin SDK初始化：这里要注意functions.config().firebase的拼写，Firebase的配置键是小写的，写错会导致SDK初始化失败。
• 高效数据读取：用Promise.all()并行读取团队和用户文档，比串行读取更节省时间，提升函数执行效率。
• FCM通知构建：根据业务需求自定义通知的标题和内容，必须传入用户的FCM令牌才能精准推送到目标设备。
• 错误处理：用try/catch包裹所有异步操作，捕获并打印错误，避免因异常导致函数反复重试。

部署&调试注意事项 #

• 确保你的Cloud Function服务账号拥有Firestore读取权限和Cloud Messaging发送权限，可以在Firebase控制台的IAM页面配置。
• 要确保用户文档中存储了有效的FCM令牌，否则通知会发送失败。
• 部署后可以在Firebase控制台的函数日志中查看执行情况，方便排查问题。

内容的提问来源于stack exchange，提问作者Stephen Giles