Firebase中sendToDevice()无法发送Web推送通知求助

我来帮你排查一下Firebase Cloud Functions里sendToDevice()推送没反应的问题，结合你给出的代码片段，大概率是这几个环节出了问题：

1. 代码逻辑未完整实现 #

你提供的代码只写到了console.info("Ru...")，还没有实际调用admin.messaging().sendToDevice()的核心逻辑。FCM推送需要明确构建payload、获取设备令牌，并且返回Promise确保函数执行完成。比如完整的逻辑应该是这样：

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

exports.sendNotifications = functions.database.ref('/notifications/{notificationId}')
  .onWrite((change, context) => {
    console.info("触发推送逻辑");
    // 读取新增的通知数据
    const notificationData = change.after.val();
    // 从通知数据中获取目标设备令牌（假设你的节点里存了token字段）
    const deviceToken = notificationData.token;
    
    if (!deviceToken) {
      console.error("未找到有效的设备令牌");
      return null;
    }

    // 构建符合FCM规范的推送payload
    const payload = {
      notification: {
        title: notificationData.title || "新通知",
        body: notificationData.body || "你有一条未读消息",
        sound: "default" // 可选，添加提示音
      }
    };

    // 调用sendToDevice并返回Promise，确保函数完成执行
    return admin.messaging().sendToDevice(deviceToken, payload)
      .then(response => {
        console.log("推送请求已发送", response);
        // 可选：推送完成后清理数据库中的通知记录
        return change.after.ref.remove();
      })
      .catch(error => {
        console.error("推送失败", error);
        return null;
      });
  });

2. 设备令牌（Device Token）无效或未正确获取 #

• 要确保传递给sendToDevice()的是有效且未过期的设备令牌。客户端需要通过messaging.getToken()获取令牌，并正确存储到/notifications/{notificationId}节点中。
• 如果令牌过期、设备卸载了应用，或者令牌未正确关联到你的Firebase项目，推送会静默失败。可以在函数中打印deviceToken，检查是否符合FCM令牌的格式。

3. 推送Payload格式不符合平台要求 #

FCM对Android和iOS的payload格式有不同要求：

• Android：必须包含notification或data字段；如果要后台接收，需要用data字段。
• iOS：需要确保notification字段包含title和body，并且客户端已经开启了通知权限。
• 如果你用的是Flutter、React Native等跨平台框架，还需要添加对应的clickAction字段（比如FLUTTER_NOTIFICATION_CLICK）来处理点击事件。

4. 客户端未正确配置通知接收 #

• Android：需要实现FirebaseMessagingService，重写onMessageReceived方法来处理前台通知，后台通知则由系统自动展示。
• iOS：需要在AppDelegate中配置通知权限请求，实现didReceiveRemoteNotification回调，并且确保用户已经授予通知权限。

5. Cloud Functions权限或初始化问题 #

• 确保admin.initializeApp()的配置正确，默认情况下使用functions.config().firebase是没问题的，但如果是自定义环境，需要检查服务账号的权限是否包含FCM发送权限。
• 可以在Firebase控制台的Cloud Functions日志中查看详细报错，这是排查问题最直接的方式——打开函数的日志，看看有没有推送失败的错误信息，比如令牌无效、payload格式错误等。

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