Flutter Android13无法接收FCM后台数据消息求助

针对你遇到的日志提示Background isolate already started和Service has not yet started, messages will be queued，以及无法接收纯数据消息的问题，可按以下步骤排查：

1. 确认后台消息处理函数的合规性 #

• 确保_messageHandler是顶级函数（不能是类的成员函数），且未引用任何Flutter UI相关API（后台隔离无法访问UI资源）。你的代码中函数位置正确，但需注意：
  • 避免在函数内执行未正确收尾的异步操作，防止后台隔离长期占用资源导致重复启动报错。
• 防止函数被混淆，在android/app/proguard-rules.pro中添加规则：

  -keep class io.flutter.plugins.firebase.messaging.** { *; }
  -keep class com.google.firebase.messaging.** { *; }
  -keep class 你的应用包名.** { *; } // 替换为实际包名，确保_messageHandler不被混淆
  

2. 适配Android13的后台限制 #

• 添加必要权限：在AndroidManifest.xml中添加：

  <uses-permission android:name="android.permission.POST_NOTIFICATIONS" />
  <uses-permission android:name="android.permission.FOREGROUND_SERVICE" />
  

  并在应用启动时主动请求POST_NOTIFICATIONS权限（Android13要求用户授权通知权限，否则后台消息可能被系统拦截）。
• 发送高优先级消息：构造FCM数据消息时指定priority: "high"，确保系统唤醒应用处理消息：

  {
    "to": "你的设备令牌",
    "data": {
      "key": "test_value"
    },
    "priority": "high"
  }
  

3. 排查Firebase配置与初始化 #

• 确认DefaultFirebaseOptions.currentPlatform针对Android的配置正确，google-services.json已放置在android/app目录，且包名与Firebase控制台一致。
• 确保Firebase.initializeApp和FirebaseMessaging.onBackgroundMessage仅调用一次（你的代码中在main函数调用一次是正确的，避免热重载导致重复注册，生产环境无此问题）。

4. 修复后台隔离重复启动问题 #

• 日志Background isolate already started通常是因为后台隔离未正常销毁，可尝试：
  • 在_messageHandler中确保所有异步操作都通过await完成，避免隔离长期存活。
  • 不要在后台处理函数中重复调用Firebase.initializeApp（后台隔离会自动复用main函数的初始化状态）。

5. 正确测试方式 #

• 改用Android13真机测试（模拟器后台调度逻辑与真机差异大，无法准确复现问题）。
• 测试时将应用退到后台或杀死进程，再发送FCM数据消息，观察日志是否触发_messageHandler的打印。

内容的提问来源于stack exchange，提问作者이동헌