使用Firebase Admin发送通知，设备未接收问题求助

以下是针对性的排查步骤，按优先级逐一验证：

• 验证设备令牌有效性
  设备令牌会因应用卸载、系统重置、令牌过期等场景失效。即使send()方法返回成功，无效令牌也无法触发设备通知。可以直接在Firebase控制台的云消息面板，使用该令牌手动发送测试通知，确认是否能接收。若控制台测试也失败，说明令牌已失效，需要重新获取设备端的有效令牌。

• 检查设备端通知状态

  • 确认设备已开启目标应用的通知权限：安卓需检查通知渠道是否启用，iOS需在「设置-通知」中确认应用通知权限为开启状态。
  • 排除设备免打扰模式、后台限制：部分安卓厂商会对后台应用做严格限制，导致推送无法触发；iOS设备若处于低电量模式或后台应用刷新关闭，也可能影响通知接收。
  • 确保设备网络正常，iOS设备需能正常连接APNs服务（苹果推送服务器）。

• 调整消息Payload结构
  仅发送notification字段在部分场景下（如应用后台/关闭状态）可能无法正常触发通知。尝试补充data字段或调整结构测试：

  const message = {
    notification: { title: '测试标题', body: '测试内容' },
    data: { type: 'alert', content: '测试数据' },
    token: '你的设备令牌'
  };
  

  同时确认设备端的消息处理逻辑（如安卓的FirebaseMessagingService、iOS的didReceiveRemoteNotification方法）能正确解析notification或data类型的消息。

• 核对Firebase项目配置一致性

  • 确认服务端firebase-admin.json对应的Firebase项目，与设备端集成的项目完全一致，项目ID、应用包名/Bundle ID必须严格匹配。
  • 检查设备端的google-services.json（安卓）或GoogleService-Info.plist（iOS）配置文件，确保包名/Bundle ID、项目ID等参数与Firebase控制台注册信息一致。

• 排查定时任务运行环境

  • 确认cron任务的Node.js环境与测试环境依赖一致，尤其是firebase-admin版本是否存在兼容性问题。
  • 检查cron任务是否有足够权限读取firebase-admin.json配置文件，避免因初始化异常导致消息未正确发送（即使日志显示成功，也需确认初始化步骤无隐藏错误）。
  • 确保cron任务运行时网络稳定，能正常访问Firebase服务器。

• 查看Firebase送达统计
  登录Firebase控制台，进入Cloud Messaging -> 报告页面，查看消息的送达数据。若存在「已发送未送达」记录，可根据控制台提示的错误原因（如令牌无效、设备离线）定位问题。

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