使用firebase-admin SDK发消息后，Firebase控制台无通知报告显示问题咨询

这种情况我之前排查过好几次，核心问题通常出在消息的标识关联或者项目配置的一致性上——设备能收到说明基础的FCM通道是通的，只是控制台没把这条消息纳入统计报告而已。下面分配置和代码两部分给你梳理：

• 确认admin SDK的服务账号归属：很多时候会不小心用了其他Firebase项目的服务账号密钥（就是那个service-account.json），导致消息实际发送到了另一个项目的设备池里，但你在当前控制台自然查不到。去Firebase控制台的「项目设置」→「服务账号」重新下载对应项目的密钥替换掉试试。
• 检查Cloud Messaging API状态：虽然消息能发送，但如果Google Cloud控制台里的Cloud Messaging API被意外禁用，可能会影响报告数据的同步。去Google Cloud控制台的API库搜索「Cloud Messaging API」，确保状态是「已启用」。

控制台的消息报告依赖消息的唯一标识或分析标签来聚合数据，纯下游单设备消息如果没有这些字段，可能不会在可视化报告里展示，甚至不会出现在消息历史中。你需要在发送的消息对象里添加以下关键字段：

举个Node.js的示例代码（其他语言逻辑一致）：

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

const sendMessage = async () => {
  const message = {
    token: 'YOUR_DEVICE_TOKEN',
    notification: {
      title: '测试通知',
      body: '这是一条admin SDK发送的消息'
    },
    // 给消息设置唯一名称，控制台会以此标识消息
    name: 'custom-message-20240520',
    // 添加分析标签，用于控制台的报告分组统计
    android: {
      fcm_options: {
        analytics_label: 'admin-sdk-campaign'
      }
    },
    apns: {
      payload: {
        aps: {
          analytics_label: 'admin-sdk-campaign'
        }
      }
    }
  };

  try {
    const response = await admin.messaging().send(message);
    console.log('消息发送成功:', response);
  } catch (error) {
    console.error('发送失败:', error);
  }
};

sendMessage();

• name字段：相当于给消息一个唯一ID，Firebase控制台会用这个ID来追踪消息的发送状态和统计数据；
• analytics_label：用于将同批次的消息归类到同一个报告分组里，方便在控制台查看整体的送达率、打开率等数据。

另外注意：控制台的报告数据不是实时的，发送后可能需要等待5-10分钟才能看到更新，别着急立刻去查。

内容的提问来源于stack exchange，提问作者Cuong Nguyen Manh