后台接收Firebase通知点击后无法跳转至指定Activity问题排查

这个问题在Firebase消息推送场景里很常见，核心原因是应用后台时Firebase对通知的处理逻辑和前台不同，再加上你的PendingIntent配置不够完善，导致点击通知时默认跳转到了启动器Activity（MainActivity）。下面是具体的分析和解决方案：

问题根源 #

当应用处于后台时：

• 如果收到的是Firebase的通知消息（带有notification字段的消息），系统会直接接管通知的显示，不会触发onMessageReceived方法。点击通知时，系统会默认启动应用的启动器Activity（也就是你的MainActivity），完全忽略你在代码中构建的跳转Intent。
• 只有数据消息（仅包含data字段的消息）才会在后台时触发onMessageReceived，让你完全控制通知的构建和跳转逻辑。

另外，你当前的Intent flags和PendingIntent flags配置也有不足：后台启动Activity需要额外的flags，且Android 12及以上版本对PendingIntent的flags有新的强制要求。

解决方案 #

1. 优先使用Firebase数据消息 #

让服务器发送仅包含data字段的消息，示例格式如下：

{
  "data": {
    "title": "通知标题",
    "body": "通知内容",
    "fid": "你的fid参数"
  },
  "to": "目标设备的FCM token"
}

这样不管应用在前台还是后台，都会触发onMessageReceived，确保你能自己构建跳转Intent。

2. 修正Intent和PendingIntent的配置 #

修改sendNotification方法中的Intent flags和PendingIntent构建逻辑，适配后台跳转需求：

private void sendNotification(String messageTitle,String messageBody, String fid) {
    Intent intent;
    if(fid != null){
        intent = new Intent(this, NewNotificationPostInfoActivity.class);
        intent.putExtra(Intent.EXTRA_TEXT, fid);
        // 加上FLAG_ACTIVITY_NEW_TASK，后台启动Activity必须的flag
        intent.addFlags(Intent.FLAG_ACTIVITY_CLEAR_TOP | Intent.FLAG_ACTIVITY_NEW_TASK);
    }else{
        intent = new Intent(this, MainActivity.class);
        intent.addFlags(Intent.FLAG_ACTIVITY_CLEAR_TOP | Intent.FLAG_ACTIVITY_NEW_TASK);
    }

    // 使用TaskStackBuilder构建正确的返回栈，避免跳转异常
    TaskStackBuilder stackBuilder = TaskStackBuilder.create(this);
    stackBuilder.addNextIntentWithParentStack(intent);

    // 适配Android 12+的PendingIntent flags要求
    int pendingFlags;
    if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.S) {
        pendingFlags = PendingIntent.FLAG_IMMUTABLE | PendingIntent.FLAG_ONE_SHOT;
    } else {
        pendingFlags = PendingIntent.FLAG_ONE_SHOT;
    }
    PendingIntent pendingIntent = stackBuilder.getPendingIntent(0, pendingFlags);

    // 以下是原有的通知构建逻辑，保持不变
    String channelId = "channelID";
    Bitmap largeIcon = BitmapFactory.decodeResource(getResources(), R.drawable.luvtas_au2);
    Uri defaultSoundUri = RingtoneManager.getDefaultUri(RingtoneManager.TYPE_NOTIFICATION);
    NotificationCompat.Builder notificationBuilder = new NotificationCompat.Builder(this, channelId)
            .setContentTitle(messageTitle)
            .setSmallIcon(R.drawable.luvtas_au3)
            .setLargeIcon(largeIcon)
            .setContentText(messageBody)
            .setAutoCancel(true)
            .setSound(defaultSoundUri)
            .setDefaults(Notification.DEFAULT_ALL)
            .setGroup(channelId)
            .setContentIntent(pendingIntent);

    NotificationManager notificationManager = (NotificationManager) getSystemService(Context.NOTIFICATION_SERVICE);
    if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.O) {
        NotificationChannel channel = new NotificationChannel(channelId, "Channel human readable title", NotificationManager.IMPORTANCE_DEFAULT);
        notificationManager.createNotificationChannel(channel);
    }
    notificationManager.notify(0, notificationBuilder.build());
}

3. 检查Activity的Manifest配置 #

确保NewNotificationPostInfoActivity在AndroidManifest.xml中没有设置特殊的launchMode（比如singleTask），如果必须设置，需要调整Intent的flags来兼容。例如：

<activity
    android:name=".NewNotificationPostInfoActivity"
    android:launchMode="singleTop"> <!-- 如果设置了singleTop，需要确保Intent能正确触发onNewIntent -->
</activity>

如果设置了singleTop，记得在NewNotificationPostInfoActivity中重写onNewIntent方法，获取传递的fid参数：

@Override
protected void onNewIntent(Intent intent) {
    super.onNewIntent(intent);
    String fid = intent.getStringExtra(Intent.EXTRA_TEXT);
    // 处理fid逻辑
}

验证步骤 #

1. 让服务器发送数据消息（仅含data字段）
2. 将应用退到后台，发送通知并点击
3. 验证是否正确跳转到NewNotificationPostInfoActivity并获取到fid参数

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