Firebase Cloud Functions批量推送通知无法触达全部用户求助

1. 未处理sendEach的部分失败场景 #

admin.messaging().sendEach()不会因单条消息失败抛出全局异常，只会在返回的responses数组中标记每条消息的成功/失败状态。当前代码仅完成发送动作，完全忽略这些局部失败，导致部分推送失效时无法察觉，也无法清理无效设备令牌。

修复方式：
发送后遍历响应结果，记录失败信息并清理无效令牌：

// 替换原有的sendEach调用逻辑
const response = await admin.messaging().sendEach(messages.splice(0, 500));
response.responses.forEach((resp, idx) => {
  if (!resp.success) {
    const failedToken = messages[idx].token;
    console.error(`推送失败，令牌: ${failedToken}，错误原因: ${resp.error.message}`);
    // 可选：标记该令牌无效，避免后续重复发送
    const userId = usersQuerySnapshot.docs.find(doc => doc.data().deviceToken === failedToken)?.id;
    if (userId) {
      admin.firestore().collection("users").doc(userId).update({ deviceToken: "" });
    }
  }
});

2. 推送配置未兼容Android设备 #

代码仅配置了iOS的APNs字段，Android设备的推送音效等配置缺失。部分Android厂商系统需要明确指定android字段配置才能生效：

const payload = {
  notification: {
    title: title,
    body: body,
    sound: "pushPop.m4a" // 通用基础配置
  },
  apns: {
    payload: {
      aps: {
          sound: "pushPop.m4a"
      }
    }
  },
  android: {
    notification: {
      sound: "pushPop.m4a" // 明确Android端音效配置
    }
  },
  data: {
      type: "NewPost",
      postId: postId
  },
  token: deviceToken
}

3. 存在云函数超时风险 #

若用户量级较大（数千以上），循环批量发送的逻辑可能触发Firebase云函数的超时限制（免费层90秒，付费层最长540秒），导致部分推送未执行完成。可优化方向：

• 拆分任务到Cloud Tasks队列，避免单次函数执行过载
• 控制并发发送的批量大小，平衡发送效率与执行时间

4. 异常日志信息不足 #

当前catch块仅打印错误对象，建议补充堆栈信息，便于定位深层问题：

catch (error) {
  console.error("推送任务全局失败", error.stack);
  return Promise.resolve();
}

关于async/await的问题 #

你的async/await使用逻辑无明显错误：循环内凑够500条即等待发送，最后处理剩余消息的流程是合理的，不是导致部分推送失败的直接原因。

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