Android端Firebase后台通知无法正常工作问题咨询

报错信息：A background message could not be handled in Dart as no onBackgroundMessage handler has been registered.

解决这个问题需要同时完成Dart端处理器注册和Android端配置，具体步骤如下：

1. 注册Dart后台消息处理器 #

首先要定义一个顶级函数（或静态函数）作为后台消息处理逻辑，然后在应用初始化时注册这个处理器。注意：这个函数不能是类的实例方法，因为后台运行时没有Flutter上下文。

示例代码：

// 必须是顶级函数（类外部定义）
Future<void> _firebaseMessagingBackgroundHandler(RemoteMessage message) async {
  // 初始化Firebase（如果应用启动时没初始化的话）
  await Firebase.initializeApp();
  print('后台消息已接收并处理: ${message.messageId}');
  // 在这里添加你的后台消息处理逻辑，比如本地通知、数据同步等
}

void main() async {
  WidgetsFlutterBinding.ensureInitialized();
  await Firebase.initializeApp();
  // 注册后台消息处理器
  FirebaseMessaging.onBackgroundMessage(_firebaseMessagingBackgroundHandler);
  runApp(const MyApp());
}

2. 配置AndroidManifest.xml #

在Android项目的AndroidManifest.xml文件中，找到<application>标签，添加FlutterFire的后台消息服务配置，让Android系统能够触发Dart端的处理器：

<application
    android:name="${applicationName}"
    android:icon="@mipmap/ic_launcher"
    android:label="Your App Name">
    <!-- 其他已有配置 -->
    
    <!-- 添加这行服务配置 -->
    <service
        android:name="io.flutter.plugins.firebase.messaging.FlutterFirebaseMessagingBackgroundService"
        android:exported="false" />
</application>

注意事项 #

• 后台处理器中不能使用Flutter的UI相关API，只能做一些无上下文的操作（比如发送本地通知、更新本地存储、调用API等）。
• 确保你的firebase_messaging依赖版本是最新的，避免因版本兼容导致的问题。
• 测试后台消息时，需要将应用退到后台或者完全杀掉进程，前台消息由FirebaseMessaging.onMessage处理，不会触发这个报错。

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