Flutter集成Firebase Messaging：Debug正常收消息，Release仅前台可收

1. 签名与Firebase控制台一致性验证 #

• 核对Release构建的签名密钥SHA-1/SHA-256，确保与Firebase控制台添加的指纹完全一致，不要混淆debug和release密钥
• 执行./gradlew signingReport，复制Release变体对应的完整SHA值更新到Firebase控制台，重新下载google-services.json替换至android/app目录
• 检查android/app/build.gradle的signingConfigs.release块，确认keystore路径、别名、密码配置正确，且构建时确实使用该签名配置

2. AndroidManifest推送配置检查 #

• 确认FirebaseMessagingService注册完整，无混淆或遗漏：

  <service
      android:name=".MyFirebaseMessagingService"
      android:exported="false">
      <intent-filter>
          <action android:name="com.google.firebase.MESSAGING_EVENT" />
      </intent-filter>
  </service>
  

• 验证通知通道配置：代码中需创建有效的通知通道，且推送消息需指定正确的通道ID，后台/离线消息依赖系统通知通道展示
• 确认必要权限存在，如RECEIVE_BOOT_COMPLETED（若需开机后接收消息）

3. 混淆规则（ProGuard/R8）验证 #

• 在android/app/proguard-rules.pro中添加Firebase相关豁免规则，避免核心类被混淆：

  -keep class com.google.firebase.** { *; }
  -keep class com.google.android.gms.** { *; }
  -keep class com.google.firebase.messaging.** { *; }
  -keep class androidx.core.app.** { *; }
  

• 查看build/outputs/mapping/release/mapping.txt，确认Firebase Messaging相关类未被混淆

4. 消息发送格式校验 #

• 后台发送消息时，使用通知消息或包含notification字段的数据消息，后台/离线状态下系统依赖该字段触发通知栏展示
• 设置消息priority为high（Android平台），高优先级消息才能在应用后台/离线时唤醒系统
• 使用Firebase控制台的Cloud Messaging测试工具，选择Release构建的目标设备进行测试，确保推送目标正确

5. 构建流程与缓存清理 #

• 执行flutter clean后重新构建Release版本，清除旧缓存文件
• 核对firebase_messaging插件版本与原生firebase-messaging依赖版本的兼容性
• 检查buildTypes.release配置，确认minifyEnabled开启时已添加必要混淆规则，shrinkResources未误删推送相关资源

内容的提问来源于stack exchange，提问作者Łukasz Garczynski