Android应用：实现Firebase通知跳转指定页面的技术问询

嘿，我之前也做过类似的FCM通知跳转需求，刚好踩过一些坑，给你梳理下完整的实现步骤和注意点，应该能帮你搞定~

1. 先确保Firebase Functions传递正确的Payload #

首先要在云函数里把跳转所需的标识和参数放在data字段里，而不是只依赖notification字段——因为当应用在后台时，系统会直接处理notification内容，data字段才会完整传递到应用里。举个云函数的示例：

// Firebase Functions 中构造通知 Payload
const payload = {
  notification: {
    title: "新订单提醒",
    body: "您有一笔新订单待处理"
  },
  data: {
    target_screen: "ORDER_DETAILS", // 自定义的页面跳转标识
    order_id: "ORD_20240501_001"     // 目标页面需要的参数
  },
  token: userFcmToken // 用户的FCM Token
};

admin.messaging().send(payload);

2. 在MyFirebaseMessagingService中构建跳转逻辑 #

接下来在你的MyFirebaseMessagingService.java里，处理收到的消息并构建带跳转参数的PendingIntent：

@Override
public void onMessageReceived(RemoteMessage remoteMessage) {
    super.onMessageReceived(remoteMessage);

    // 提取通知中的数据字段
    Map<String, String> data = remoteMessage.getData();
    String targetScreen = data.get("target_screen");
    String orderId = data.get("order_id");

    // 构建跳转Intent：先指向主Activity，再在主Activity中分发跳转
    Intent intent = new Intent(this, MainActivity.class);
    intent.putExtra("target_screen", targetScreen);
    intent.putExtra("order_id", orderId);
    // 设置Flag避免重复创建Activity栈
    intent.setFlags(Intent.FLAG_ACTIVITY_NEW_TASK | Intent.FLAG_ACTIVITY_CLEAR_TASK);

    // 创建PendingIntent：Android 12+ 必须添加FLAG_IMMUTABLE或FLAG_MUTABLE
    PendingIntent pendingIntent = PendingIntent.getActivity(
            this,
            0,
            intent,
            PendingIntent.FLAG_UPDATE_CURRENT | PendingIntent.FLAG_IMMUTABLE
    );

    // 构建并显示通知
    NotificationCompat.Builder builder = new NotificationCompat.Builder(this, "YOUR_CHANNEL_ID")
            .setSmallIcon(R.drawable.ic_notification_icon)
            .setContentTitle(remoteMessage.getNotification().getTitle())
            .setContentText(remoteMessage.getNotification().getBody())
            .setPriority(NotificationCompat.PRIORITY_DEFAULT)
            .setContentIntent(pendingIntent)
            .setAutoCancel(true);

    NotificationManagerCompat notificationManager = NotificationManagerCompat.from(this);
    notificationManager.notify(1, builder.build());
}

3. 在Launcher Activity中处理跳转分发 #

这里要注意：如果应用在后台，系统展示的通知被点击时，会直接打开你的Launcher Activity（通常是MainActivity），所以需要在MainActivity中处理跳转逻辑：

public class MainActivity extends AppCompatActivity {
    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);
        // 处理启动时的Intent
        handleNotificationJump(getIntent());
    }

    @Override
    protected void onNewIntent(Intent intent) {
        super.onNewIntent(intent);
        setIntent(intent);
        // 处理应用在前台时的新Intent
        handleNotificationJump(intent);
    }

    private void handleNotificationJump(Intent intent) {
        if (intent == null || intent.getExtras() == null) return;

        String targetScreen = intent.getStringExtra("target_screen");
        String orderId = intent.getStringExtra("order_id");

        // 根据标识跳转到指定页面
        if ("ORDER_DETAILS".equals(targetScreen)) {
            Intent detailIntent = new Intent(this, OrderDetailsActivity.class);
            detailIntent.putExtra("order_id", orderId);
            startActivity(detailIntent);
        }
        // 可以添加其他页面的跳转逻辑，比如"USER_PROFILE"跳转到个人中心等
    }
}

4. 几个关键坑点要注意 #

• Android 12+ 权限要求：必须给PendingIntent添加FLAG_IMMUTABLE（跳转场景推荐）或FLAG_MUTABLE，否则会抛出异常。
• 栈结构优化：如果需要保持正确的返回栈（比如从订单详情页返回主页面），可以用TaskStackBuilder来构建PendingIntent，替代直接创建PendingIntent.getActivity：

TaskStackBuilder stackBuilder = TaskStackBuilder.create(this);
stackBuilder.addNextIntentWithParentStack(intent);
PendingIntent pendingIntent = stackBuilder.getPendingIntent(
        0,
        PendingIntent.FLAG_UPDATE_CURRENT | PendingIntent.FLAG_IMMUTABLE
);

• 数据可靠性：所有跳转相关的参数一定要放在data字段里，notification字段的内容可能在系统处理时被截断或丢失，data字段会完整传递到应用。

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