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
相关产品推荐
相关产品推荐

