You need to enable JavaScript to run this app. iOS应用中Cloud Firestore文档更新时如何给关联用户发送通知?
优惠活动
大模型
产品
解决方案
定价
更多

iOS应用中Cloud Firestore文档更新时如何给关联用户发送通知?

方案可行性确认

这个需求完全可以实现,Firestore + Cloud Functions for Firebase + FCM 是 Firebase 生态下对应这类场景的标准实现方案,不需要额外对接第三方服务。

具体实现步骤建议

1. 前期数据结构准备

  • 先在 Firestore 中完善两类必要字段:
    • 给每个用户的独立文档(推荐路径为 users/{用户UID})新增两个字段:associatedUid(存储和当前用户1对1绑定的另一方用户UID)、fcmTokens(数组类型,存储当前用户登录的所有设备的FCM令牌,覆盖用户同时登iPhone、iPad的场景)
    • iOS 端每次APP启动、用户登录时,调用 FCM SDK 获取当前设备的令牌,更新到对应用户文档的 fcmTokens 数组中;用户登出时要把对应令牌从数组中移除,避免发无效推送。

2. 编写Cloud Functions监听Firestore变更

核心逻辑是监听你提到的带确认标记字段的文档更新事件,触发后自动调用FCM发推送,以下是Node.js环境下的核心示例代码(Firebase云函数默认支持该运行环境):

const functions = require("firebase-functions");
const admin = require("firebase-admin");
admin.initializeApp();

exports.sendItemConfirmNotification = functions.firestore
  // 替换成你自己的带确认标记的文档路径
  .document("itemConfirmDocs/{docId}")
  .onUpdate(async (change, context) => {
    const newData = change.after.data();
    const oldData = change.before.data();
    // 仅当确认标记从否改为是时触发,避免其他字段更新误触发
    if (newData.isFinalized === true && oldData.isFinalized !== true) {
      // 从文档中取操作方的用户UID,该字段需要你在端上更新文档时一起写入
      const operatorUid = newData.operatorUid;
      // 获取操作方绑定的关联用户UID
      const operatorDoc = await admin.firestore().collection("users").doc(operatorUid).get();
      const receiverUid = operatorDoc.data().associatedUid;
      if (!receiverUid) return null;
      // 获取接收方的设备FCM令牌
      const receiverDoc = await admin.firestore().collection("users").doc(receiverUid).get();
      const fcmTokens = receiverDoc.data().fcmTokens || [];
      if (fcmTokens.length === 0) return null;
      // 构造推送内容
      const payload = {
        notification: {
          title: "关联用户已确认items内容",
          body: "请点击查看待执行操作",
          sound: "default"
        },
        // 自定义字段,端上收到推送后可以用来跳转对应页面
        data: {
          type: "item_finalized",
          itemDocId: newData.itemDocId
        }
      };
      // 批量给接收方的所有设备发推送
      const response = await admin.messaging().sendEachForMulticast({
        tokens: fcmTokens,
        ...payload
      });
      // 清理无效令牌(用户卸载APP、重装后令牌会失效)
      const invalidTokens = [];
      response.responses.forEach((resp, idx) => {
        if (!resp.success && 
          (resp.error.code === "messaging/invalid-registration-token" || 
          resp.error.code === "messaging/registration-token-not-registered")) {
          invalidTokens.push(fcmTokens[idx]);
        }
      });
      if (invalidTokens.length > 0) {
        await admin.firestore().collection("users").doc(receiverUid).update({
          fcmTokens: admin.firestore.FieldValue.arrayRemove(...invalidTokens)
        });
      }
      return null;
    }
    return null;
  });

3. iOS端适配工作

  • 集成FCM SDK,申请推送权限,这部分逻辑和你熟悉的本地通知申请权限流程差异不大,只要把系统返回的推送令牌传给FCM SDK即可
  • 实现FCM的令牌更新回调,每次令牌更新时同步更新到当前用户的Firestore文档fcmTokens数组中
  • 处理推送接收逻辑:APP在前台时可以自行弹本地通知,APP在后台/杀死状态下FCM会自动弹出系统通知,用户点击通知时可以拿到自定义的itemDocId字段,直接跳转到对应的items页面即可
避坑提醒
  • 不要在iOS端直接调用FCM接口发推送,会暴露服务端密钥,所有推送请求必须走云函数处理
  • Firestore安全规则要做好权限限制,仅允许用户自己修改自己的fcmTokens字段,避免其他用户恶意读取、篡改
  • 如果是高优先级的重要通知,可以加端上补偿逻辑:用户打开APP时主动检查是否有未处理的items确认事件,避免因为推送送达率问题漏掉提示

内容的提问来源于stack exchange,提问作者KatM

相关产品推荐
方舟 Agent Plan

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

最近更新时间:2026.10.11 20:45:02