Flutter Firebase Messaging安卓端后台/终止状态消息不显示问题

针对你遇到的「Flutter集成Firebase Messaging，Android仅前台正常，后台/终止态APK安装不显示通知（AS直接运行正常）」的问题，给你几个针对性的排查和解决方向：

1. 修复ProGuard混淆规则（最可能的原因） #

Release包的APK默认会开启混淆，而Firebase Messaging和本地通知的相关类如果被混淆，会导致后台处理器无法正常执行。在android/app/proguard-rules.pro中添加以下规则：

# Firebase Messaging 相关类不混淆
-keep class com.google.firebase.messaging.** { *; }
-keep class com.google.firebase.iid.** { *; }
-keep class com.google.android.gms.common.** { *; }
-keep class com.google.android.gms.tasks.** { *; }

# Flutter Local Notifications 插件不混淆
-keep class com.dexterous.** { *; }

然后重新打包release APK，确保build.gradle中release配置的minifyEnabled true时，这些规则生效。

2. 统一Firebase初始化配置 #

你的后台处理器_firebaseMessagingBackgroundHandler中，Firebase初始化只调用了await Firebase.initializeApp();，但前台初始化用了自定义的name: 'Firebase-App'和options，后台隔离环境中必须和前台初始化完全一致，否则会初始化失败。修改后台处理器的初始化代码：

static Future<void> _firebaseMessagingBackgroundHandler(RemoteMessage message) async {
  await Firebase.initializeApp(
    name: 'Firebase-App',
    options: DefaultFirebaseOptions.currentPlatform,
  );
  // 后续的本地通知代码保持不变
}

3. 优化通知渠道的创建逻辑 #

后台处理器中不需要重复创建通知渠道，只需要在前台初始化时创建一次即可。删除_firebaseMessagingBackgroundHandler中重复的AndroidNotificationChannel创建代码，直接使用已创建的渠道ID调用flutterLocalNotificationsPlugin.show即可。

4. 验证Release签名与Firebase配置一致性 #

检查Firebase控制台中你的Android应用是否添加了Release包的签名指纹（SHA-1/SHA-256）：

• 打开Firebase控制台 → 项目设置 → 你的Android应用 → 签名证书指纹
• 确保你打包Release APK用的签名文件对应的SHA-1和SHA-256已添加
• 重新下载google-services.json替换到项目的android/app目录下，再重新打包

5. 确认后台处理器是否执行 #

在_firebaseMessagingBackgroundHandler中添加日志，然后通过adb logcat查看Release包的日志：

static Future<void> _firebaseMessagingBackgroundHandler(RemoteMessage message) async {
  print('[BG HANDLER] 收到后台消息: ${message.data}');
  // 初始化和通知代码
}

执行命令：

adb logcat | grep "\[BG HANDLER\]"

如果没有输出，说明后台处理器未被触发，回到步骤1检查ProGuard规则，或者确认Firebase消息的优先级设置为High。

6. 检查消息类型与优先级 #

• 确保你发送的是数据消息（或者通知+数据的混合消息），纯通知消息在后台/终止态下由系统直接展示，不会触发你的后台处理器；
• 发送消息时设置Android优先级为High，否则系统可能延迟或忽略后台消息（Firebase控制台发送时选择「高优先级」，API发送时设置priority: "high"）。

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