Android：点击后台Firebase通知无法获取Data Payload，求代码排查

看起来你遇到的是Firebase Cloud Messaging（FCM）里很常见的通知数据传递问题，我来帮你一步步排查解决：

1. 先理清FCM通知的两种核心类型 #

FCM推送分通知消息和数据消息，两者的处理逻辑差异直接影响你能不能拿到Data Payload：

• 通知消息：后台推送时由系统自动展示通知栏，点击后默认启动你的App启动页（Launcher Activity）。这种情况下，控制台添加的Data Payload理论上会被封装到启动Activity的Intent Extras中，但前提是你得正确获取到最新的Intent。
• 数据消息：无论App处于前台还是后台，都会直接触发FirebaseMessagingService的onMessageReceived()方法，需要你手动构建通知栏，并自己控制点击通知后的Intent数据传递。

2. 检查Activity的Intent获取时机 #

如果你的Activity设置了单例启动模式（比如launchMode="singleTop"或singleTask），点击通知时系统不会创建新的Activity实例，而是调用onNewIntent()方法。这时候你在onCreate()里调用getIntent()拿到的是旧的Intent，自然看不到新的Data Payload。

解决办法是在onNewIntent()里更新Intent并重新处理：

@Override
protected void onNewIntent(Intent intent) {
    super.onNewIntent(intent);
    setIntent(intent); // 替换当前Activity的Intent为最新的
    handleNotificationData(); // 调用你的数据处理逻辑
}

private void handleNotificationData() {
    Bundle extras = getIntent().getExtras();
    if (extras != null) {
        Set<String> keys = extras.keySet();
        for (String key : keys) {
            Log.d("notiffff", key + ": " + extras.getString(key));
        }
    }
}

记得同时在onCreate()里也调用handleNotificationData()，覆盖首次创建Activity的场景。

3. 确认控制台的推送配置 #

你在Firebase控制台添加的Data Payload要确保是在通知消息的「可选Data Payload」区域填写的键值对，而不是其他地方。另外，如果你是在App后台时推送的通知消息，系统会接管通知展示，这时候Data Payload会被自动附加到启动Intent中——但如果你的App被完全杀死，部分厂商的系统可能会过滤掉这些额外数据，这时候可能需要用数据消息+自定义通知的方式来规避。

4. 数据消息场景的手动处理（如果适用） #

如果你的推送是数据消息（或者想完全控制通知逻辑），一定要在onMessageReceived()里手动构建通知，并把Data Payload放到PendingIntent中：

@Override
public void onMessageReceived(RemoteMessage remoteMessage) {
    // 获取Data Payload
    Map<String, String> data = remoteMessage.getData();
    
    // 构建跳转Intent
    Intent intent = new Intent(this, YourTargetActivity.class);
    intent.putExtras(new Bundle(data)); // 把Data数据存入Intent
    intent.addFlags(Intent.FLAG_ACTIVITY_CLEAR_TOP | Intent.FLAG_ACTIVITY_NEW_TASK);
    
    // 创建PendingIntent
    PendingIntent pendingIntent = PendingIntent.getActivity(
        this,
        0,
        intent,
        PendingIntent.FLAG_UPDATE_CURRENT | PendingIntent.FLAG_IMMUTABLE
    );
    
    // 构建通知并显示
    NotificationCompat.Builder builder = new NotificationCompat.Builder(this, "CHANNEL_ID")
        .setSmallIcon(R.drawable.ic_notification)
        .setContentTitle(remoteMessage.getNotification() != null ? remoteMessage.getNotification().getTitle() : "新通知")
        .setContentText(remoteMessage.getNotification() != null ? remoteMessage.getNotification().getBody() : "收到一条新消息")
        .setContentIntent(pendingIntent)
        .setAutoCancel(true);
    
    NotificationManagerCompat notificationManager = NotificationManagerCompat.from(this);
    notificationManager.notify(1, builder.build());
}

这种方式下，点击通知后就能在目标Activity中通过getIntent().getExtras()拿到完整的Data Payload了。

最后调试小技巧 #

在onCreate()和onNewIntent()里都打印Intent的完整信息，比如：

Log.d("notiffff", "Current Intent: " + getIntent().toString());

这样能帮你确认Intent是否携带了预期的Data字段，也能排查是不是系统厂商的定制化过滤导致数据丢失。

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