Flutter签名包完全关闭时Firebase后台通知失效问题

针对你遇到的**仅签名包完全关闭时无法触发FirebaseMessaging.onBackgroundMessage**的问题，按以下步骤排查：

1. 验证Firebase项目的签名哈希值 #

调试包与签名包使用不同签名密钥，必须将正式签名的SHA-1和SHA-256哈希值添加到Firebase项目设置中：

• 用命令生成正式keystore的哈希值：

  keytool -list -v -keystore your-release-keystore.jks -alias your-alias
  

• 登录Firebase控制台，进入项目设置→应用→添加上述哈希值，重新下载google-services.json替换到项目android/app目录下。

2. 检查后台处理函数的合规性 #

_firebaseMessagingBackgroundHandler必须满足以下要求：

• 是顶级函数（不能是类的成员方法），示例：

  Future<void> _firebaseMessagingBackgroundHandler(RemoteMessage message) async {
    await Firebase.initializeApp();
    // 仅执行非UI操作，比如记录日志、更新本地存储等
    print("后台收到消息: ${message.messageId}");
  }
  

• 函数内部不能调用Flutter的UI相关API（如showDialog），后台隔离环境无法访问Flutter引擎。

3. 检查AndroidManifest配置 #

确保android/app/src/main/AndroidManifest.xml包含必要配置：

• 添加通知权限（targetSdkVersion ≥33时）：

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

• 确认Firebase消息服务声明（firebase_messaging通常自动配置，手动检查更稳妥）：

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

4. 处理系统电池优化限制 #

国产安卓设备（小米、华为、OPPO、vivo等）的电池优化会严格限制后台进程：

• 进入手机设置→电池→应用耗电管理→找到你的应用，设置为允许后台活动、关闭“智能省电”或“深度睡眠”模式。
• 部分机型需将应用加入“自启动白名单”。

5. 排查混淆与构建配置 #

若release开启代码混淆（minifyEnabled true），需在android/app/proguard-rules.pro中添加Firebase相关规则：

-keep class com.google.firebase.** { *; }
-keep class io.flutter.plugins.firebase.messaging.** { *; }
-keep class com.google.android.gms.** { *; }

同时确保build.gradle的release签名配置正确：

signingConfigs {
    release {
        keyAlias 'your-alias'
        keyPassword 'your-password'
        storeFile file('your-release-keystore.jks')
        storePassword 'your-store-password'
    }
}

buildTypes {
    release {
        signingConfig signingConfigs.release
        // 若开启混淆，确保上述proguard规则生效
        minifyEnabled true
        proguardFiles getDefaultProguardFile('proguard-android-optimize.txt'), 'proguard-rules.pro'
    }
}

6. 验证消息Payload格式 #

发送后台消息时，确保Payload包含data字段（纯notification消息可能被系统直接展示，不会触发后台函数）：
示例Payload：

{
  "data": {
    "title": "后台消息",
    "body": "这是一条后台触发的消息"
  },
  "to": "你的设备token"
}

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