Flutter应用后台/终止状态订阅Firebase Topic的实现与异常解决

需求背景 #

我的应用里有一个所有用户都订阅的默认推送主题“DEFAULT”。每当创建新主题时，会通过这个“DEFAULT”主题给所有用户发送带新主题名称的推送通知（放在数据负载里）。应用收到通知后从负载提取新主题，判断有效就订阅，无效则忽略。

前台正常运行代码 #

前台状态下的处理代码可以正常工作：

static void _handleForegroundMessages() async {
    FirebaseMessaging.onMessage.listen((RemoteMessage message) {
      String? topicChannel = message.data['topic'];
      if (topicChannel != null && topicChannel == PredefinedNotificationTopic.topicCreated.name) {
        String newTopic = message.data['newTopicToSubscribe'];
        FCMHelper.addToUserTopicList(newTopic);
      }
      _showLocalNotification(message);
    })
};

后台/终止状态下的异常 #

但后台或应用终止状态下的同类代码抛出了以下异常：

E/flutter (24845): [ERROR:flutter/runtime/dart_vm_initializer.cc(41)] Unhandled Exception: [core/no-app] No Firebase App '[DEFAULT]' has been created - call Firebase.initializeApp()
E/flutter (24845): #0      MethodChannelFirebase.app (package:firebase_core_platform_interface/src/method_channel/method_channel_firebase.dart:193:5)
E/flutter (24845): #1      Firebase.app (package:firebase_core/src/firebase.dart:56:41)
E/flutter (24845): #2      FirebaseMessaging.instance (package:firebase_messaging/src/messaging.dart:32:47)
E/flutter (24845): #3      FCMService.subscribeToTopics (package:fourdrinier/service/fcm_service.dart:52:25)
E/flutter (24845): #4      FCMHelper.addToUserTopicList (package:fourdrinier/service/fcm_helper.dart:45:18)
E/flutter (24845): <asynchronous suspension>

后台处理器代码 #

我用于后台处理的代码如下，通过FirebaseMessaging.onBackgroundMessage(FCMService.backgroundHandler)调用：

static Future<void> backgroundHandler(RemoteMessage message) async {
    String? topicChannel = message.data['topic'];
    debugPrint("Background notification with $topicChannel");
    if (topicChannel != null && topicChannel == PredefinedNotificationTopic.topicCreated.name) {
      String newTopic = message.data['newTopicToSubscribe'];
      FCMHelper.addToUserTopicList(newTopic);
    }
  }

疑问 #

这个需求能实现吗？有没有可行的解决方案？

解决方案 #

这个需求完全可以实现，问题根源是后台隔离环境独立于应用主进程，必须手动初始化Firebase实例。

修改后台处理器代码即可解决：

static Future<void> backgroundHandler(RemoteMessage message) async {
    // 后台环境必须先初始化Firebase
    await Firebase.initializeApp();
    
    String? topicChannel = message.data['topic'];
    debugPrint("Background notification with $topicChannel");
    if (topicChannel != null && topicChannel == PredefinedNotificationTopic.topicCreated.name) {
      String newTopic = message.data['newTopicToSubscribe'];
      FCMHelper.addToUserTopicList(newTopic);
    }
  }

额外注意事项：

• 后台处理器必须是顶级函数或静态函数，不能依赖应用上下文相关逻辑
• 确保firebase_core包已正确添加到项目依赖，版本与其他Firebase包兼容
• 如果使用自定义Firebase配置（如多环境配置），需要在初始化时传入对应参数：

  await Firebase.initializeApp(
    options: DefaultFirebaseOptions.currentPlatform,
  );
  

• 后台处理逻辑要尽量轻量化，避免耗时操作，防止被系统强制终止

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