Android 31+通知蹦床阻塞：Xamarin Forms代码级解决方案问询

问题背景 #

在Xamarin Forms 5中集成Azure Notification Hub推送后，Android 12（API 31）的Pixel 6a设备上，应用后台时点击非静默通知触发indirect notification activity start (trampoline) blocked for X错误，无法唤起应用；修改Payload添加pressAction后问题依旧，且不想让用户手动修改开发者设置。

核心原因 #

Android 12+ 严格限制后台间接启动Activity（即“蹦床”行为），任何通过后台Service中转启动Activity的操作都会被系统拦截，必须通过通知的PendingIntent直接绑定目标Activity。

解决方案 #

1. 手动创建合规的Notification Channel #

在Android项目的FirebaseMessagingService中创建通知渠道，确保重要性设置正确，避免依赖系统默认行为：

private void CreateNotificationChannel()
{
    if (Build.VERSION.SdkInt >= BuildVersionCodes.O)
    {
        var channelId = "app_notification_channel";
        var channelName = "应用通知";
        var channelDesc = "接收应用推送通知";
        var importance = NotificationImportance.High;

        var channel = new NotificationChannel(channelId, channelName, importance)
        {
            Description = channelDesc,
            EnableVibration = true,
            EnableLights = true
        };

        var notificationManager = (NotificationManager)GetSystemService(NotificationService);
        notificationManager.CreateNotificationChannel(channel);
    }
}

2. 构建直接绑定目标Activity的PendingIntent #

避免通过中间Service跳转，直接将PendingIntent绑定到主Activity，并设置Android 12+要求的flags：

private PendingIntent GetTargetActivityIntent(IDictionary<string, string> pushData)
{
    // 指向你的主Activity
    var intent = new Intent(this, typeof(MainActivity));
    // 传递推送数据
    foreach (var kvp in pushData)
    {
        intent.PutExtra(kvp.Key, kvp.Value);
    }
    // 设置启动模式，避免重复创建Activity实例
    intent.SetFlags(ActivityFlags.ClearTop | ActivityFlags.SingleTop);
    
    // Android 12+ 必须设置Immutable/Mutable flag
    var flags = PendingIntentFlags.UpdateCurrent | PendingIntentFlags.Immutable;
    return PendingIntent.GetActivity(this, 0, intent, flags);
}

3. 调整Azure Notification Hub的Payload格式 #

确保Payload中明确指定click_action，且与AndroidManifest中Activity的action匹配，同时避免多余的跳转配置：

{
    "notification": {
        "title": "测试通知",
        "body": "点击查看详情",
        "click_action": "OPEN_MAIN_ACTIVITY"
    },
    "data": {
        "orderId": "12345"
    },
    "android": {
        "notification": {
            "channel_id": "app_notification_channel",
            "press_action": {
                "action": "OPEN_MAIN_ACTIVITY",
                "target_activity": "com.your.app.package.MainActivity"
            }
        }
    }
}

同时在AndroidManifest.xml的主Activity中添加对应的intent-filter：

<activity android:name=".MainActivity"
          android:launchMode="singleTop">
    <intent-filter>
        <action android:name="OPEN_MAIN_ACTIVITY" />
        <category android:name="android.intent.category.DEFAULT" />
    </intent-filter>
</activity>

4. 直接在FirebaseMessagingService中构建通知（推荐） #

绕过Azure推送的自动通知构建逻辑，手动用NotificationCompat.Builder创建通知，完全控制PendingIntent：

public override void OnMessageReceived(RemoteMessage message)
{
    base.OnMessageReceived(message);
    
    // 先创建通知渠道
    CreateNotificationChannel();
    
    var pushTitle = message.GetNotification()?.Title ?? "通知";
    var pushContent = message.GetNotification()?.Body ?? "新消息";
    var pushData = message.Data;
    
    // 获取绑定主Activity的PendingIntent
    var pendingIntent = GetTargetActivityIntent(pushData);
    
    // 构建通知
    var notificationBuilder = new NotificationCompat.Builder(this, "app_notification_channel")
        .SetSmallIcon(Resource.Drawable.ic_notification_icon)
        .SetContentTitle(pushTitle)
        .SetContentText(pushContent)
        .SetPriority(NotificationCompat.PriorityHigh)
        .SetContentIntent(pendingIntent)
        .SetAutoCancel(true)
        .SetVisibility(NotificationCompat.VisibilityPublic);
    
    // 发送通知
    var notificationManager = NotificationManagerCompat.From(this);
    notificationManager.Notify(DateTime.Now.Millisecond, notificationBuilder.Build());
}

排查要点 #

• 禁止在后台Service中调用StartActivity，所有页面跳转必须通过通知的PendingIntent触发
• Android 12+ 中PendingIntent必须设置Immutable或Mutable，否则会触发权限错误
• click_action的名称必须和Manifest中Activity的action完全一致，大小写敏感
• 不要使用系统默认的通知渠道，必须手动创建并指定channel_id

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