使用firebase云函数从Firebase发送推送通知

基础概念

Firebase Cloud Functions（云函数）是 Firebase 提供的无服务器计算服务，允许开发者在云端运行后端代码，无需管理服务器基础设施。结合 Firebase Cloud Messaging (FCM)，可以通过云函数在特定事件（如数据库变更、用户注册等）触发时自动发送推送通知。

优势

无服务器架构：无需管理服务器，自动扩展。
事件驱动：响应 Firebase 事件（如数据库写入、用户认证）。
集成 FCM：直接调用 FCM API 发送推送通知。
成本效益：按实际执行次数和资源消耗计费。

实现步骤

1. 初始化 Firebase 项目

确保已安装 Firebase CLI 并初始化项目：

npm install -g firebase-tools
firebase login
firebase init functions

2. 安装依赖

在 functions 目录下安装 firebase-admin：

cd functions
npm install firebase-admin

3. 编写云函数

以下是一个示例代码，当 Firestore 文档创建时发送推送通知：

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

exports.sendNotificationOnNewPost = functions.firestore
  .document('posts/{postId}')
  .onCreate(async (snapshot, context) => {
    const postData = snapshot.data();
    const userId = postData.userId;

    // 获取用户的 FCM 令牌（假设存储在 Firestore 的 'users' 集合中）
    const userDoc = await admin.firestore().doc(`users/${userId}`).get();
    const fcmToken = userDoc.data().fcmToken;

    if (!fcmToken) {
      console.log('No FCM token found for user:', userId);
      return null;
    }

    // 构造通知消息
    const message = {
      notification: {
        title: 'New Post',
        body: `A new post was created: ${postData.title}`,
      },
      token: fcmToken,
    };

    // 发送通知
    try {
      await admin.messaging().send(message);
      console.log('Notification sent successfully');
    } catch (error) {
      console.error('Error sending notification:', error);
    }
  });

4. 部署云函数

firebase deploy --only functions

常见问题及解决

1. FCM 令牌无效或过期

原因：用户可能卸载应用或令牌被刷新。
解决：定期更新 Firestore 中的令牌，或在发送前检查令牌有效性。

2. 权限不足

原因：未正确初始化 firebase-admin 或服务账号缺少权限。
解决：确保 admin.initializeApp() 已调用，且服务账号具有 cloudmessaging.messages.create 权限。

3. 通知未触发

原因：云函数未正确绑定事件或部署失败。
解决：检查 Firebase 控制台的日志，确认函数已部署且监听正确的事件路径。

应用场景

社交应用：新评论、点赞时通知用户。
电商平台：订单状态更新时通知买家。
实时协作工具：文档变更时通知协作者。

扩展功能

多平台支持：通过 topic 或 condition 发送给多设备。
数据驱动通知：动态生成通知内容（如用户名、订单号）。
异步处理：使用 Promise.all 批量发送通知。

注意事项

冷启动延迟：云函数首次调用可能有延迟，可通过保持实例活跃优化。
配额限制：FCM 有发送速率限制，需合理设计触发频率。