Flutter：如何在firebase_messaging包中定义通知渠道？仅使用data payload推送FCM通知未显示的问题排查

你猜的没错，Android通知渠道未初始化是核心问题之一，但还有个关键细节：FCM的data payload不会像notification payload那样由系统自动展示通知——它需要你的App手动接收并构建通知。下面一步步帮你解决：

1. 为什么Data Payload不自动显示？ #

FCM的两种Payload处理逻辑完全不同：

• notification payload：由Google Play服务的FCM系统进程处理，不管App前台/后台，系统都会直接弹出通知（只要配置正确）。
• data payload：会直接传递给你的App进程（后台时需要通过后台消息处理器接收），必须由App自己编写代码解析并调用通知API展示。

而Android 8.0（API 26）及以上版本，所有通知都必须绑定到一个已创建的通知渠道，否则系统会直接忽略这条通知——这就是你遇到的核心卡点。

2. 第一步：创建对应的Android通知渠道 #

根据你Payload里的channelKey: "basic_channel"，你需要先在App初始化时创建这个渠道。假设你用的是Flutter的awesome_notifications库（从Payload字段格式来看高度匹配），可以直接在Flutter端初始化渠道：

await AwesomeNotifications().initialize(
  'resource://drawable/app_icon', // 替换成你的App图标路径
  [
    NotificationChannel(
      channelKey: 'basic_channel',
      channelName: '基础通知渠道',
      channelDescription: '用于展示常规通知的渠道',
      defaultColor: Colors.blue,
      importance: NotificationImportance.High, // 高优先级才能弹出通知
      channelShowBadge: true,
      playSound: true,
    )
  ],
);

如果用原生Android代码创建渠道（比如在MainActivity的onCreate方法里）：

if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.O) {
    val channel = NotificationChannel(
        "basic_channel",
        "Basic Channel",
        NotificationManager.IMPORTANCE_HIGH
    ).apply {
        description = "Default channel for basic notifications"
    }
    val notificationManager = getSystemService(NotificationManager::class.java)
    notificationManager.createNotificationChannel(channel)
}

3. 第二步：处理FCM Data消息并展示通知 #

你需要配置FCM的消息处理器，在收到data payload时，解析内容并调用通知库显示通知。

Flutter端后台消息处理（App在后台/杀死状态） #

Future<void> firebaseMessagingBackgroundHandler(RemoteMessage message) async {
  await Firebase.initializeApp();
  
  // 解析Data Payload里的内容
  final contentJson = Map<String, dynamic>.from(message.data['content'] as Map);
  final actionButtonsJson = List<Map<String, dynamic>>.from(
    (message.data['actionButtons'] as List).map((item) => Map<String, dynamic>.from(item))
  );
  
  // 用AwesomeNotifications创建通知
  await AwesomeNotifications().createNotification(
    content: NotificationContent.fromJson(contentJson),
    actionButtons: actionButtonsJson.map((btn) => NotificationActionButton.fromJson(btn)).toList(),
  );
}

// 在main函数里初始化
void main() async {
  WidgetsFlutterBinding.ensureInitialized();
  await Firebase.initializeApp();
  
  // 初始化通知渠道（前面的代码）
  await AwesomeNotifications().initialize(/* 填入你的配置 */);
  
  // 设置后台消息处理器
  FirebaseMessaging.onBackgroundMessage(firebaseMessagingBackgroundHandler);
  
  // 前台消息处理（可选，App在前台时也显示通知）
  FirebaseMessaging.onMessage.listen((message) {
    // 复用同样的解析和创建通知逻辑
  });
  
  runApp(MyApp());
}

关键注意事项 #

• 确保你的App已配置FCM后台消息处理权限：在AndroidManifest.xml里添加：

  <service
    android:name="io.flutter.plugins.firebasemessaging.FlutterFirebaseMessagingBackgroundService"
    android:exported="false" />
  

• 通知渠道的importance必须设为High或Max，否则后台通知可能不会弹出。
• 如果你用的是其他通知库（比如flutter_local_notifications），只需要把创建通知的代码换成对应库的API即可，核心逻辑一致：解析data -> 确保渠道存在 -> 展示通知。

这样处理后，当你发送仅包含data payload的FCM消息时，App就能正确接收并弹出通知了。

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