MAUI应用无法通过Firebase主题接收推送通知问题排查

核心排查方向 #

既然设备令牌直接推送正常，说明Firebase基础配置没问题，问题集中在主题订阅有效性或客户端通知处理逻辑上，按以下步骤排查：

1. 确认主题订阅是否真正成功 #

• 给订阅代码添加回调日志，验证执行结果：

  FirebaseMessaging.Instance.SubscribeToTopic("Devices")
      .AddOnCompleteListener(task => {
          if (task.IsSuccessful)
          {
              Log.Debug("FCM-Topic", "订阅Devices主题成功");
          }
          else
          {
              Log.Error("FCM-Topic", "订阅主题失败", task.Exception);
          }
      });
  

• 登录Firebase控制台，进入Cloud Messaging > 主题，搜索"Devices"主题，查看目标设备令牌是否在订阅列表中（需先获取设备令牌：FirebaseMessaging.Instance.Token.AddOnCompleteListener(...)）。
• 确保订阅代码在Firebase初始化完成后调用，比如放在MainActivity.OnCreate方法中，避免过早执行导致订阅失败。

2. 调整通知通道配置 #

你的通道使用NotificationImportance.Default，部分Android设备会对低优先级通知做静默处理，建议提升优先级并补充基础配置：

private void CreateNotificationChannel()
{
    var channelId = $"{PackageName}.Devices";
    var notificationManager = (NotificationManager)GetSystemService(NotificationService);
    // 提升优先级为High，确保通知能正常弹出
    var channel = new NotificationChannel(channelId, "Devices", NotificationImportance.High);
    // 开启震动、默认通知音
    channel.EnableVibration(true);
    channel.SetSound(RingtoneManager.GetDefaultUri(RingtoneType.Notification), null);
    notificationManager.CreateNotificationChannel(channel);
    FirebaseCloudMessagingImplementation.ChannelId = channelId;
    
    // 订阅主题并验证
    FirebaseMessaging.Instance.SubscribeToTopic("Devices")
        .AddOnCompleteListener(task => {
            if (task.IsSuccessful)
            {
                Log.Debug("FCM-Topic", "订阅Devices主题成功");
            }
            else
            {
                Log.Error("FCM-Topic", "订阅主题失败", task.Exception);
            }
        });
}

确保该方法在MainActivity.OnCreate中调用，保证应用启动时就创建好通道。

3. 检查FirebaseMessagingService实现 #

如果自定义了消息服务类，需确保正确处理推送消息：

• 通过特性标注注册服务：

  [Service]
  [IntentFilter(new[] { "com.google.firebase.MESSAGING_EVENT" })]
  public class MyFirebaseMessagingService : FirebaseMessagingService
  {
      public override void OnMessageReceived(RemoteMessage message)
      {
          base.OnMessageReceived(message);
          
          // 打印日志确认收到主题推送
          if (message.Notification != null)
          {
              Log.Debug("FCM-Message", $"标题：{message.Notification.Title}，内容：{message.Notification.Body}");
          }
          
          // 处理数据消息（如果有）
          if (message.Data.Count > 0)
          {
              foreach (var kvp in message.Data)
              {
                  Log.Debug("FCM-Data", $"{kvp.Key}: {kvp.Value}");
              }
          }
          
          // 手动构建通知显示（部分场景系统不会自动弹出）
          ShowNotification(message);
      }
      
      private void ShowNotification(RemoteMessage message)
      {
          var intent = new Intent(this, typeof(MainActivity));
          intent.AddFlags(ActivityFlags.ClearTop);
          var pendingIntent = PendingIntent.GetActivity(this, 0, intent, PendingIntentFlags.OneShot | PendingIntentFlags.Immutable);
          
          var notificationBuilder = new NotificationCompat.Builder(this, FirebaseCloudMessagingImplementation.ChannelId)
              .SetSmallIcon(Resource.Drawable.ic_notification)
              .SetContentTitle(message.Notification?.Title ?? "主题推送")
              .SetContentText(message.Notification?.Body ?? "收到主题消息")
              .SetAutoCancel(true)
              .SetContentIntent(pendingIntent);
          
          var notificationManager = NotificationManagerCompat.From(this);
          notificationManager.Notify(0, notificationBuilder.Build());
      }
  }
  

4. 验证推送发送方式 #

• 先通过Firebase控制台发送主题推送（Cloud Messaging > 发送测试消息 > 选择主题"Devices"），如果控制台能收到，说明你的测试应用发送逻辑可能存在问题；如果控制台也收不到，继续排查客户端配置。
• 确认Firebase.Admin版本与客户端Firebase SDK版本兼容（尽量保持大版本一致）。

5. 检查基础配置 #

• 确保Android项目中的google-services.json文件放置在Resources目录下，且生成操作设置为GoogleServicesJson。
• 确认应用包名与Firebase控制台中注册的包名完全一致。

内容的提问来源于stack exchange，提问作者jason.kaisersmith