Firebase Cloud Messaging测试消息无法发送问题排查

• 确认令牌有效性
  调用getToken()后，先将令牌打印到控制台，确保没有返回null。另外，APP卸载重装后令牌会更新，要保证测试用的是最新生成的令牌，避免使用旧令牌测试。

• 检查设备基础状态

  • 设备需处于稳定联网状态，避开可能屏蔽FCM端口的受限网络（如部分企业内网）。
  • 安卓设备关闭对应APP的电池优化功能，厂商省电模式常导致FCM后台进程被查杀；iOS设备在系统设置中确认已开启该APP的通知权限。

• 验证FCM配置正确性

  • 安卓：确认google-services.json已正确放入项目根目录，文件中的包名与Firebase控制台配置完全一致；AndroidManifest.xml中已注册FirebaseMessagingService的子类服务。
  • iOS：检查GoogleService-Info.plist已添加到项目，Bundle ID与控制台匹配；Xcode的Signing & Capabilities中已开启Push Notifications能力，且APNs证书已正确上传至Firebase控制台。

• 核对测试消息发送设置
  在Firebase控制台发送测试消息时：

  • 目标类型选择「单个设备」，确保令牌输入无空格、换行等格式错误。
  • 将消息优先级设为「高」，低优先级消息在设备后台状态下易被系统延迟或忽略。

• 排查代码逻辑问题

  • 确保APP启动时先调用Firebase.initializeApp()，待初始化完成后再获取FCM令牌。
  • 安卓端重写FirebaseMessagingService的onMessageReceived方法并添加日志，确认是否接收到消息；iOS端在didReceiveRemoteNotification方法中添加日志，排查推送接收情况。

• 处理后台状态接收异常

  • 安卓（8.0及以上）：提前创建通知渠道，否则后台消息无法在系统通知栏展示。
  • iOS：在Xcode中开启Remote notifications后台模式，且测试消息需包含content-available: 1字段，才能触发后台接收逻辑。

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