Flutter Android真机无法接收Firebase后台通知原因咨询

1. 通知渠道配置限制 #

Android真机上通知渠道一旦创建就无法通过代码修改，如果之前安装过应用并创建过低优先级的同名渠道，新的高优先级配置不会生效。需要手动去手机「设置-通知」找到对应渠道删除，再重新安装应用。另外要确保渠道ID唯一，避免和其他渠道冲突。

2. 后台消息处理逻辑缺陷 #

你的firebaseMessagingBackgroundHandler存在几个潜在问题：

• 依赖message.notification和message.notification?.android的判空逻辑，但**纯数据消息（无notification字段）**会直接跳过通知展示，若后台发送的是这类消息则无法触发通知。
• json.decode(message.data['data'])未做空值校验，若message.data里没有data字段，会抛出异常导致后台任务终止。建议增加防护：

  if (message.data.containsKey('data')) {
    Map<String, dynamic> objectdata3 = json.decode(message.data['data']);
    var title = objectdata3['title'] ?? '默认标题';
    var body = objectdata3['body'] ?? '默认内容';
    // 执行通知展示逻辑
  }
  

3. 厂商系统的后台限制 #

小米、华为、OPPO等厂商的系统默认会对应用做电池优化和后台进程限制，导致Firebase后台消息Handler无法正常执行。需要：

• 将应用加入「电池优化白名单」，在设置中找到应用，关闭电池优化或设为「无限制」。
• 开启应用的「自启动权限」，部分厂商会限制非系统应用的后台自启动。

4. Firebase配置问题 #

• 检查google-services.json文件的包名是否和真机应用包名完全匹配，包名不匹配会导致消息无法送达。
• 后台Handler中的Firebase.initializeApp()在多环境配置场景下可能需要指定options参数：

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

5. 本地通知插件配置问题 #

• 代码中通知图标icon: '@mipmap/ic'需确保真机存在对应的mipmap资源，部分系统会隐藏无图标的通知。
• 后台Handler运行在Flutter主引擎的隔离环境中，可在Handler内添加日志，确认是否走到了flutterLocalNotificationsPlugin.show()方法。

6. 消息发送格式问题 #

若通过Firebase控制台发送测试消息：

• 需选择「自定义数据」而非仅「通知」，后台消息处理依赖data字段。
• 确保data字段的值是合法的JSON字符串，符合代码中json.decode的解析预期。

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