Android Studio在应用未运行时无法获取通知负载问题

• 问题根源：FCM分两种消息类型——通知消息和数据消息

  • 应用未运行时，通知消息会直接交给系统通知栏处理，根本不会触发onMessageReceived()，所以你加的日志自然打不出来
  • 只有数据消息，不管应用是前台、后台还是完全关闭状态，都会触发onMessageReceived()，让你能拿到负载并记录

• 先检查你发的消息格式：

  • 别用这种纯通知消息（应用未运行时不触发回调）：

    {
      "notification": {
        "title": "测试通知",
        "body": "这是一条通知消息"
      },
      "to": "你的设备Token"
    }
    

  • 改用数据消息格式（任何状态都能触发回调）：

    {
      "data": {
        "title": "测试数据消息",
        "body": "这是一条数据消息",
        "custom_key": "自定义负载内容"
      },
      "to": "你的设备Token"
    }
    

• 如果既要系统展示通知，又要记录负载，用混合消息：
  这种格式下，前台时onMessageReceived()拿完整负载；未运行时，系统会弹通知，同时onMessageReceived()也会被触发（部分Android版本需确保data字段存在）：

  {
    "notification": {
      "title": "混合消息",
      "body": "既有通知又有数据"
    },
    "data": {
      "custom_data": "需要记录的负载内容"
    },
    "to": "你的设备Token"
  }
  

• 最后检查下基础配置：

  • 确认FirebaseMessagingService已经在AndroidManifest.xml里正确注册：

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

  • 国产ROM的话，记得给应用开自启动、后台弹出权限，不然系统可能拦截回调

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