Xamarin.Forms安卓端FCM后台推送无振动与LED提示问题

兄弟，我之前在Xamarin.Forms里搞FCM推送的时候也踩过这个后台通知没振动、不亮LED的坑！核心问题其实是后台状态下FCM通知的处理逻辑和前台完全不一样，加上旧文档里的方法大多已经废弃，很容易走弯路。下面是我亲测有效的解决方案：

1. 先搞清楚FCM的两种消息类型 #

FCM推送分「通知消息」和「数据消息」，后台状态下的处理逻辑天差地别：

• 通知消息：后台状态下由系统直接接管显示，你的FirebaseMessagingService不会触发OnMessageReceived
• 数据消息：后台状态下仍会触发OnMessageReceived，需要你手动构建并显示通知

如果你用的是「通知消息」： #

要让后台通知触发振动/LED，必须在推送的notification字段里明确配置相关参数，而不是放在data里。示例Payload如下（针对Android）：

{
  "to": "你的设备Token",
  "notification": {
    "title": "新消息提醒",
    "body": "这是一条测试通知",
    "priority": "high", // 必须设为high，否则系统可能压低通知优先级
    "sound": "default",
    "vibrate": [200, 100, 300], // 振动模式：振动200ms→停100ms→振动300ms
    "light_settings": {
      "color": "#FF0000", // LED颜色（红色）
      "light_on_duration": "500ms",
      "light_off_duration": "500ms"
    }
  }
}

⚠️ 注意：不同平台的参数有差异，iOS的振动/LED配置逻辑不一样，这里先聚焦Android场景。

如果你用的是「数据消息」： #

后台状态下需要在FirebaseMessagingService的OnMessageReceived里手动构建通知，同时设置振动和LED属性。步骤如下：

第一步：创建Notification Channel（Android 8.0+必填）

Android 8.0及以上版本要求所有通知必须归属到一个Channel，而且Channel的配置会覆盖单个通知的设置。在你的FirebaseMessagingService子类里添加创建Channel的方法：

private void CreateNotificationChannel()
{
    if (Build.VERSION.SdkInt >= BuildVersionCodes.O)
    {
        var channelId = "your_notification_channel_id"; // 自定义Channel ID
        var channelName = "消息通知"; // Channel名称，用户在系统设置里能看到
        var channel = new NotificationChannel(channelId, channelName, NotificationImportance.High)
        {
            EnableVibration = true,
            VibrationPattern = new long[] { 200, 100, 300 }, // 振动模式
            EnableLights = true,
            LightColor = Android.Graphics.Color.Red, // LED颜色
            Description = "接收应用推送消息的通知渠道"
        };

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

记得在OnCreate方法里调用这个方法：

public override void OnCreate()
{
    base.OnCreate();
    CreateNotificationChannel();
}

第二步：手动构建通知并设置振动/LED

在OnMessageReceived里构建通知时，通过NotificationCompat.Builder配置振动和LED：

public override void OnMessageReceived(RemoteMessage message)
{
    base.OnMessageReceived(message);

    // 构建跳转Intent
    var intent = new Intent(this, typeof(MainActivity));
    intent.AddFlags(ActivityFlags.ClearTop);
    var pendingIntent = PendingIntent.GetActivity(this, 0, intent, PendingIntentFlags.OneShot);

    // 构建通知
    var notificationBuilder = new NotificationCompat.Builder(this, "your_notification_channel_id")
        .SetContentTitle(message.Data["title"])
        .SetContentText(message.Data["body"])
        .SetSmallIcon(Resource.Drawable.ic_notification) // 替换成你的通知图标
        .SetAutoCancel(true)
        .SetContentIntent(pendingIntent)
        // 覆盖Channel的振动设置（如果需要的话）
        .SetVibrate(new long[] { 200, 100, 300 })
        // 覆盖Channel的LED设置（如果需要的话）
        .SetLights(Android.Graphics.Color.Red, 500, 500)
        .SetPriority((int)NotificationPriority.High);

    // 显示通知
    var notificationManager = NotificationManager.FromContext(this);
    notificationManager.Notify(0, notificationBuilder.Build());
}

2. 必查的权限和系统设置 #

• Android权限：在AndroidManifest.xml里添加振动权限：

<uses-permission android:name="android.permission.VIBRATE" />

• 设备系统设置：有些设备默认会关闭第三方应用的振动/LED提示，去设备的「设置→应用→你的应用→通知」里，确保「振动」和「LED提示」是开启状态。

3. 常见坑点 #

• 不要依赖旧文档里的Notification.Builder（已废弃），一定要用NotificationCompat.Builder兼容低版本
• 通知优先级必须设为High，否则后台状态下系统可能不触发振动/LED
• 如果是通知消息，参数一定要放在notification字段里，data字段的配置系统不会读取

内容的提问来源于stack exchange，提问作者met.lord