求助：Android端Flutter应用被任务管理器划掉后无法接收FCM推送

• 核心现象：应用处于前台/后台时推送功能正常，被任务管理器划掉（完全终止）后无法接收推送；iOS端无论应用状态如何，推送均正常。
• 后端推送配置：包含data和notification两种payload。
• Debug模式异常：划掉应用后，系统应用信息中的「强制停止」按钮呈灰色不可点击，其他应用无此情况。

依赖版本 #

firebase_core: ^2.11.0
firebase_messaging: ^14.5.0
firebase_crashlytics: ^3.2.0
flutter_local_notifications: ^13.0.0

核心代码片段（main.dart） #

@pragma('vm:entry-point')
Future<dynamic> _firebaseMessagingBackgroundHandler(
    RemoteMessage message) async {
  await FCMService.instance.setupBasics(); // 包含Firebase.initializeApp()，标注仅执行一次
  await FCMService.instance.showFlutterNotification(message);
}

Future<void> main() async {
  try {
    WidgetsBinding widgetsBinding = WidgetsFlutterBinding.ensureInitialized();
    await FCMService.instance.setupBasics(); // 包含Firebase.initializeApp()，标注仅执行一次
    FirebaseMessaging.onBackgroundMessage(_firebaseMessagingBackgroundHandler);
    FlutterNativeSplash.preserve(widgetsBinding: widgetsBinding);
  } catch (e) {
    // 原代码未处理异常，建议补充捕获逻辑
  }
}

可能原因与解决方案 #

1. Android厂商后台限制（核心诱因） #

国内主流Android厂商（小米、华为、OPPO、vivo等）对应用后台进程有严格管控，当应用被任务管理器划掉时，会直接终止所有关联进程，包括FCM的后台监听服务。iOS依赖系统级APNs推送通道，不受此限制。

解决操作：

• 给应用开启「后台运行权限」：进入应用信息→权限管理→后台运行权限→设置为「允许」
• 关闭厂商省电优化：进入应用信息→电池优化→设置为「不允许」；或在系统设置的电池模块中关闭对应应用的智能休眠/省电模式
• 锁定应用：在任务管理器中长按应用卡片，选择「锁定」，避免被系统自动清理

2. FCM后台消息处理逻辑问题 #

从代码看，后台消息处理器中调用了自定义的setupBasics()，但后台进程的初始化环境与前台不同，可能存在初始化失败的情况，导致推送无法触发本地通知。

优化代码：
简化后台处理器逻辑，避免依赖复杂的自定义初始化：

@pragma('vm:entry-point')
Future<void> _firebaseMessagingBackgroundHandler(RemoteMessage message) async {
  // 直接初始化Firebase，无需依赖自定义服务
  await Firebase.initializeApp();
  
  // 直接调用本地通知插件显示推送，确保逻辑独立
  final FlutterLocalNotificationsPlugin localNotifications = FlutterLocalNotificationsPlugin();
  const AndroidNotificationDetails androidChannel = AndroidNotificationDetails(
    'push_channel',
    '推送通知',
    importance: Importance.max,
    priority: Priority.high,
  );
  const NotificationDetails notificationDetails = NotificationDetails(android: androidChannel);
  
  await localNotifications.show(
    message.hashCode,
    message.data['title'] ?? message.notification?.title ?? '新通知',
    message.data['content'] ?? message.notification?.body ?? '',
    notificationDetails,
    payload: message.data.toString(),
  );
}

• 确保@pragma('vm:entry-point')注解未遗漏，该注解用于防止R8混淆后台方法，避免触发失败。

3. 「强制停止」按钮变灰的异常排查 #

该现象说明系统认为应用仍处于运行状态，但实际进程已被终止，大概率是自定义后台服务（如Service、WorkManager）未正确销毁，导致系统状态不一致。

排查步骤：

• 检查是否有自定义后台服务未在应用退出时调用stopSelf()或正确解绑
• 确认FirebaseMessaging相关资源在应用终止时已正确释放
• 切换到Release模式测试，Debug模式的系统进程管控逻辑可能与正式环境有差异

4. 推送Payload格式优化 #

Android应用终止时，notification payload由系统直接处理，但如果应用被厂商限制后台权限，可能被拦截；data payload需要应用后台进程处理，更依赖应用的后台存活能力。

优化建议：

• 后端优先发送data payload，将标题、内容等字段放在data中，完全由应用控制通知展示逻辑
• 避免依赖系统处理notification payload，减少被厂商拦截的概率

内容的提问来源于stack exchange，提问作者Jason The Dynamite