React Native安卓应用集成Azure通知中心推送无响应问题排查

我之前也踩过类似的坑，给你整理了几个针对性的排查步骤，应该能帮你解决Azure Notification Hub推送无响应的问题：

1. 确认设备Token已正确注册到Azure #

• 首先得确保React Native应用获取到的Firebase设备Token确实成功上传到了Azure Notification Hub。你可以在插件的onRegister回调里打印出token，然后登录Azure Portal，找到你的Notification Hub，查看“注册”列表，确认这个token存在，并且关联的是Android（FCM）平台。
• 小提示：有些场景下插件可能返回旧token或无效token，建议每次App启动时重新获取token并更新Azure的注册记录。

2. 核对Azure与Firebase的配置细节 #

• 确认你在Azure里填写的是Firebase的Server Key（不是Web API Key或其他密钥），这个密钥可以在Firebase控制台的「项目设置」→「云消息传递」中找到，是一串较长的字符。
• 检查Azure Notification Hub的「通知设置」里，Android平台的「包名」是否和你React Native安卓应用的包名完全一致（比如com.yourappname），大小写也必须匹配，这个细节很容易被忽略。

3. 验证插件的FCM集成完整性 #

• 虽然本地通知正常，但FCM推送需要额外配置：
  • 确认android/app/src/main/AndroidManifest.xml中已添加FCM相关的服务和接收器，示例代码如下：

    <service
        android:name="com.dieam.reactnativepushnotification.modules.RNPushNotificationListenerService"
        android:exported="false" >
        <intent-filter>
            <action android:name="com.google.firebase.MESSAGING_EVENT" />
        </intent-filter>
    </service>
    

  • 检查google-services.json是否正确放置在android/app目录下，且文件内的package_name与应用包名完全一致。

4. 确保Azure推送的Payload格式兼容插件 #

• Azure推送FCM消息时，Payload格式必须符合react-native-push-notification的解析逻辑。建议同时包含notification和data字段，提升不同场景下的接收可靠性，示例Payload如下（可在Azure的测试发送功能中使用）：

  {
      "notification": {
          "title": "测试推送",
          "body": "来自Azure的测试消息"
      },
      "data": {
          "title": "测试推送",
          "message": "来自Azure的测试消息"
      }
  }
  

• 仅传notification字段可能在App后台被杀死时无法接收，加上data字段能覆盖更多场景。

5. 检查设备的通知权限与后台限制 #

• 确认设备已给应用开启所有通知权限，包括锁屏通知、横幅通知等。
• 安卓12及以上版本，需检查应用的「后台活动」权限是否开启，部分厂商的定制系统会限制后台App接收推送。
• 优先使用真实设备测试，模拟器偶尔会出现FCM推送的兼容性问题。

6. 通过日志定位问题根源 #

• 利用安卓的Logcat工具，过滤关键词RNPushNotification或FirebaseMessaging，查看是否有错误日志（比如token获取失败、推送接收时的解析错误等）。
• 登录Azure Portal，查看Notification Hub的「监控」→「操作日志」，检查推送请求的状态，若有失败记录，可根据失败原因进一步排查（比如token无效、权限不足等）。

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