Swift iOS聊天应用：如何通过Firebase编程发送群聊推送通知

核心结论 #

不建议由用户X的客户端直接发送通知，客户端既无权限直接调用推送服务接口，也存在安全风险。当前标准方案是通过**Firebase Cloud Functions（云函数）**触发推送逻辑，具体实现如下：

1. 前置准备 #

• 确保Firebase项目已配置Cloud Messaging（FCM），iOS端完成FCM集成：获取设备令牌（FCM Token），并将令牌存储到Firebase的用户文档中（比如给每个用户文档新增fcmTokens数组，保存该用户所有设备的令牌）
• 启用Firebase Cloud Functions，安装Firebase CLI工具

2. 云函数触发推送逻辑 #

当用户X向texts集合添加新消息文档时，自动触发云函数执行以下步骤：

1. 从新消息文档中提取群聊ID、发送者UID、消息内容
2. 查询groupChats集合中对应群聊的allUsersUID数组，排除发送者X的UID，得到需要通知的用户A、B、C的UID列表
3. 批量查询这些用户的文档，收集他们的FCM令牌
4. 构造推送通知内容（标题、正文、自定义跳转数据）
5. 调用FCM API向目标令牌发送推送通知

云函数示例代码（TypeScript） #

import * as functions from "firebase-functions";
import * as admin from "firebase-admin";
admin.initializeApp();

exports.sendGroupMessageNotification = functions.firestore
  .document("texts/{messageId}")
  .onCreate(async (snap, context) => {
    const messageData = snap.data();
    if (!messageData) return;

    // 提取消息关键信息
    const groupId = messageData.groupId;
    const senderUid = messageData.senderUid;
    const messageText = messageData.text;

    // 获取群聊的所有用户UID
    const groupDoc = await admin.firestore().collection("groupChats").doc(groupId).get();
    const groupData = groupDoc.data();
    if (!groupData?.allUsersUID) return;

    // 过滤掉发送者，得到目标用户UID
    const targetUserUids = groupData.allUsersUID.filter(uid => uid !== senderUid);
    if (targetUserUids.length === 0) return;

    // 批量收集目标用户的FCM令牌
    const userDocs = await admin.firestore().collection("users")
      .where(admin.firestore.FieldPath.documentId(), "in", targetUserUids).get();
    let fcmTokens: string[] = [];
    userDocs.forEach(doc => {
      const tokens = doc.data().fcmTokens as string[];
      if (tokens) fcmTokens = [...fcmTokens, ...tokens];
    });
    if (fcmTokens.length === 0) return;

    // 构造推送内容
    const payload = {
      notification: {
        title: "新群消息",
        body: messageText,
        sound: "default"
      },
      data: {
        groupId: groupId,
        messageId: context.params.messageId
      }
    };

    // 发送推送
    try {
      await admin.messaging().sendToDevice(fcmTokens, payload);
      functions.logger.info("通知发送成功");
    } catch (error) {
      functions.logger.error("通知发送失败", error);
    }
  });

3. iOS端配套处理 #

• 在AppDelegate或SceneDelegate中实现FCM令牌的获取与上传逻辑，确保用户的设备令牌实时同步到Firebase用户文档
• 处理通知接收与点击事件：当用户点击推送通知时，直接跳转到对应的群聊页面

关于客户端直接发送的限制 #

无法由用户X的客户端直接向其他用户发送通知，原因：

• iOS的APNs服务要求推送请求必须来自可信服务器，客户端没有调用权限
• FCM同样限制客户端仅能向自身设备发送通知，无法操作其他用户的令牌
• 客户端发送存在安全风险，可能被恶意利用发送垃圾通知

额外优化建议 #

• 记录用户在线状态，仅向离线用户发送通知，减少无效推送
• 自定义通知标题，比如显示发送者昵称而非固定文本
• 在云函数中捕获无效令牌，自动从用户文档中移除，避免后续推送失败

内容的提问来源于stack exchange，提问作者Ahmed Zaidan