Firebase Functions发送iOS重复推送及getResult多次触发问题排查

这是个很常见的Firebase Functions + FCM推送问题，我碰到过好几个开发者遇到类似的情况，来帮你拆解下可能的原因和对应的解决办法：

1. Firebase Functions触发器重复触发 #

这是最常见的原因之一。Firebase Functions的触发器（比如Firestore的onWrite/onCreate）会因为几种情况重复执行：

• 系统重试机制：如果你的函数执行超时、抛出错误，或者Firebase服务端出现临时波动，系统会自动重试函数执行，导致多次触发推送逻辑。
• 触发器类型选择错误：比如你用了onWrite而不是onCreate，onWrite会在文档创建、更新、删除时都触发，如果帖子发布后有后续的字段更新（比如统计数变化），会再次触发函数，重复推送。
• 本地调试/部署缓存：本地用emulator调试时，可能会因为缓存或者重复触发事件导致函数多次执行；部署新版本时，旧的函数实例可能还在运行，短暂时间内新旧实例都处理事件。

解决办法：

• 优先使用更精准的触发器：如果只需要在帖子发布（文档创建）时推送，改用onCreate代替onWrite。
• 给函数添加幂等性处理：在Firestore的帖子文档里加一个字段（比如notificationSent，默认false），函数执行前先检查这个字段：

  exports.sendPostNotification = functions.firestore.document('posts/{postId}')
    .onCreate(async (snap, context) => {
      const postData = snap.data();
      // 先检查是否已经推送过
      if (postData.notificationSent) {
        console.log('Notification already sent for this post, skipping');
        return null;
      }
      
      const fcmToken = postData.fcmToken;
      // 推送逻辑...
      
      // 推送成功后更新标记
      await snap.ref.update({ notificationSent: true });
      return null;
    });
  

• 调整函数超时时间：如果是超时导致的重试，在firebase.json里增加函数的超时配置（最大90秒）。

2. FCM推送逻辑重复调用 #

可能你的代码里不小心重复执行了推送操作：

• 比如在异步逻辑里没有正确处理Promise，导致sendToDevice被多次调用；
• 或者帖子里的FCM令牌被重复存储（比如用户多次提交，导致文档里的令牌数组有重复项）。

解决办法：

• 检查异步代码：如果是循环处理令牌，用for...of配合await，避免用forEach（forEach不支持异步等待，会导致多个推送同时触发）：

  // 错误示例：forEach会同时触发所有推送
  tokens.forEach(token => {
    admin.messaging().sendToDevice(token, payload);
  });
  
  // 正确示例：逐个处理，避免重复
  for (const token of tokens) {
    await admin.messaging().sendToDevice(token, payload);
  }
  

• 对FCM令牌去重：如果帖子里的令牌是数组，先去重再发送：

  const uniqueTokens = [...new Set(postData.fcmTokens)];
  

3. FCM/APNs的重试与通知合并问题 #

iOS的APNs（Apple Push Notification service）和FCM之间的交互也可能导致重复通知：

• 如果iOS设备没有及时确认收到通知，FCM会自动重试推送；
• 没有设置collapseKey，导致相同内容的通知会被多次显示。

解决办法：

• 添加collapseKey参数：用帖子的唯一ID作为collapseKey，这样即使FCM多次推送，iOS会合并相同key的通知，只显示最新的一条：

  const payload = {
    notification: {
      title: '新帖子发布',
      body: `用户${postData.userName}发布了新内容`
    },
    collapse_key: `post_${context.params.postId}` // 用帖子ID作为collapse key
  };
  
  await admin.messaging().sendToDevice(fcmToken, payload);
  

• 检查iOS端的通知处理：确保iOS app正确处理了APNs的通知回调，及时确认接收，避免APNs重复发送。

4. 函数部署后的冷启动与并发问题 #

当你的函数长时间没有被调用，Firebase会回收实例，下次调用时会冷启动实例，有时候会因为并发请求导致多个实例同时处理同一个事件，触发多次推送。

解决办法：

• 利用Firestore的事务处理：在检查notificationSent标记时，用事务确保只有一个实例能执行推送逻辑，避免并发冲突：

  await admin.firestore().runTransaction(async (transaction) => {
    const postRef = snap.ref;
    const postDoc = await transaction.get(postRef);
    if (postDoc.data().notificationSent) {
      return null;
    }
    // 执行推送逻辑...
    transaction.update(postRef, { notificationSent: true });
  });
  

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