Flutter Android通知问题：未找到可启动应用的Activity

核心问题拆解 #

从控制台日志和现象来看，通知触发了后台处理但无法显示，主要由三个问题导致，逐个解决即可：

1. 「Missing google_app_id」错误 #

这是Firebase配置缺失导致的基础问题，虽不直接影响通知显示，但会引发其他依赖问题：

• 检查android/app目录下是否存在google-services.json文件（从Firebase控制台下载对应Android应用的配置文件）。
• 确认android/build.gradle中添加了Google服务插件依赖：

  dependencies {
    classpath 'com.google.gms:google-services:4.4.0' // 版本可匹配当前Firebase SDK
  }
  

• 确认android/app/build.gradle末尾添加了插件应用：

  apply plugin: 'com.google.gms.google-services'
  

2. 「Notification Channel未创建」错误（关键影响通知显示） #

Android 8.0（API 26）及以上系统要求必须创建通知渠道才能显示通知，否则系统会使用默认渠道但可能无法正常展示：

• 添加flutter_local_notifications依赖到pubspec.yaml：

  dependencies:
    flutter_local_notifications: ^16.1.0 # 使用最新稳定版本
  

• 在应用初始化时创建通知渠道（比如main函数中）：

  final FlutterLocalNotificationsPlugin _notificationsPlugin = FlutterLocalNotificationsPlugin();
  
  Future<void> initNotificationChannel() async {
    // 初始化通知插件
    const AndroidInitializationSettings androidInit = AndroidInitializationSettings('@mipmap/ic_launcher');
    await _notificationsPlugin.initialize(const InitializationSettings(android: androidInit));
  
    // 创建高优先级通知渠道
    const AndroidNotificationChannel channel = AndroidNotificationChannel(
      'notification_channel_id',
      '应用通知',
      description: '接收应用推送通知',
      importance: Importance.max,
    );
    await _notificationsPlugin.resolvePlatformSpecificImplementation<AndroidFlutterLocalNotificationsPlugin>()?.createNotificationChannel(channel);
  }
  

• 发送通知时（无论是Firebase控制台还是后端接口），指定的channelId要和上面创建的一致。

3. 「No activity found to launch app」错误 #

这是通知点击后无法跳转应用的问题，本质是主Activity配置异常：

• 打开android/app/src/main/AndroidManifest.xml，确保主Activity配置了以下内容：

  <activity
      android:name=".MainActivity"
      android:exported="true" <!-- Android 12+必须设置为true -->
      android:launchMode="singleTop">
      <!-- 主入口过滤规则 -->
      <intent-filter>
          <action android:name="android.intent.action.MAIN"/>
          <category android:name="android.intent.category.LAUNCHER"/>
      </intent-filter>
      <!-- 通知点击跳转过滤规则 -->
      <intent-filter>
          <action android:name="FLUTTER_NOTIFICATION_CLICK"/>
          <category android:name="android.intent.category.DEFAULT"/>
      </intent-filter>
  </activity>
  

4. 后台处理器未主动显示通知（核心遗漏） #

你当前的后台处理器仅打印日志，如果发送的是数据消息（payload仅含data字段），Firebase不会自动弹出通知，必须手动调用显示逻辑：
修改后台处理器代码：

@pragma('vm:entry-point')
Future<void> _firebaseMessagingBackgroundHandler(RemoteMessage message) async {
  print("Handling a background message: ${message.messageId}");

  // 后台环境需重新初始化通知插件
  final FlutterLocalNotificationsPlugin notificationsPlugin = FlutterLocalNotificationsPlugin();
  const AndroidInitializationSettings androidInit = AndroidInitializationSettings('@mipmap/ic_launcher');
  await notificationsPlugin.initialize(const InitializationSettings(android: androidInit));

  // 确保渠道已创建
  const AndroidNotificationChannel channel = AndroidNotificationChannel(
    'notification_channel_id',
    '应用通知',
    description: '接收应用推送通知',
    importance: Importance.max,
  );
  await notificationsPlugin.resolvePlatformSpecificImplementation<AndroidFlutterLocalNotificationsPlugin>()?.createNotificationChannel(channel);

  // 构建并显示通知
  const AndroidNotificationDetails androidDetails = AndroidNotificationDetails(
    'notification_channel_id',
    '应用通知',
    channelDescription: '接收应用推送通知',
    importance: Importance.max,
    priority: Priority.high,
  );
  await notificationsPlugin.show(
    DateTime.now().millisecondsSinceEpoch % 10000, // 唯一通知ID
    message.data['title'] ?? '新通知',
    message.data['body'] ?? '您有一条未读消息',
    const NotificationDetails(android: androidDetails),
  );
}

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