构建Release版*.aab时onBackgroundMessage始终未触发求助

1. 补充R8/ProGuard混淆规则 #

AAB默认启用R8混淆，即使APK正常，AAB的混淆逻辑可能遗漏FCM相关类，需在android/app/proguard-rules.pro中添加：

# 保留Firebase核心类
-keep class com.google.firebase.** { *; }
# 保留FCM消息处理类
-keep class com.google.firebase.messaging.** { *; }
# 保留Flutter FCM插件类
-keep class io.flutter.plugins.firebase.messaging.** { *; }

同时确认android/build.gradle中若开启minifyEnabled true，需确保上述规则生效。

2. 核对签名证书指纹 #

AAB发布用的签名密钥指纹必须和Firebase控制台注册的一致：

• 检查Firebase项目中应用的SHA-1/SHA-256指纹，是否包含AAB签名密钥的指纹（注意APK和AAB可能用不同密钥，比如debug和release keystore）。
• 指纹不匹配会导致FCM消息无法正确触发后台处理器。

3. 升级firebase_messaging依赖版本 #

Flutter 3.3.0对应的旧版本firebase_messaging可能存在AAB适配问题，尝试更新到兼容的稳定版：
在pubspec.yaml中修改依赖：

firebase_messaging: ^14.6.0 # 选择适配Flutter 3.3.0的最新稳定版

执行flutter pub get后重新构建AAB。

4. 确保后台处理器符合严格要求 #

onBackgroundMessage在AAB环境下的限制更严格，必须满足：

• 是顶级独立函数，不能是类方法或闭包
• 内部不能调用Flutter插件或UI相关代码，仅用原生Dart API
• 正确添加@pragma注解：

@pragma('vm:entry-point')
Future<void> firebaseMessagingBackgroundHandler(RemoteMessage message) async {
  await Firebase.initializeApp();
  // 仅用Dart原生逻辑处理data消息、调用本地通知
}

5. 通过Google Play渠道测试AAB #

本地直接安装AAB的环境和Google Play分发后的包有差异，建议上传AAB到Google Play内部测试渠道，下载正式分发的安装包后测试推送。

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