Flutter FCM Android Release模式消息推送异常问题求助

核心问题回顾 #

• iOS端、Android Debug模式、flutter run --release模式下FCM主题推送均正常
• 通过flutter build --release构建的APK安装后，完全无法接收FCM Data消息，但本地定时通知正常（排除基础权限问题）
• FCM控制台推送测试消息时，会触发积压的历史消息，说明消息未丢失，而是等待触发条件

排查与解决方案 #

1. 验证APK签名与Firebase配置一致性 #

flutter run --release和flutter build --release的签名配置可能存在差异，需确认发布APK的签名指纹与Firebase控制台配置完全匹配：

• 使用apksigner工具验证APK的签名指纹：

  apksigner verify --print-certs app/build/outputs/apk/release/app-release.apk
  

• 将输出的SHA1、SHA256指纹与Firebase控制台项目设置中的应用签名证书指纹对比，确保完全一致。

2. 强制主题订阅逻辑，避免Token刷新后订阅丢失 #

发布版APK可能因Token刷新导致主题订阅失效，需在应用启动及Token刷新时主动重新订阅：

// 初始化完成后订阅主题
await Firebase.initializeApp();
await FirebaseMessaging.instance.subscribeToTopic("your_topic");

// 监听Token刷新，自动重新订阅
FirebaseMessaging.instance.onTokenRefresh.listen((newToken) async {
  await FirebaseMessaging.instance.subscribeToTopic("your_topic");
});

可通过Firebase Crashlytics添加日志，确认订阅操作是否成功执行。

3. 补全Firebase Messaging的R8/ProGuard规则 #

即使禁用了minifyEnabled，部分核心类仍可能被误处理，需在proguard-rules.pro中添加以下规则：

# Firebase Messaging 核心类保护
-keep class com.google.firebase.messaging.** { *; }
-keep class com.google.firebase.iid.** { *; }
-keep public class com.google.firebase.messaging.FirebaseMessagingService

# Flutter Local Notifications 规则
-keep class com.dexterous.** { *; }
-keep class com.google.android.gms.tasks.** { *; }

4. 调整FCM推送消息的优先级 #

Data消息默认优先级为普通，在Android后台可能被系统限制延迟送达，需在云函数推送时设置高优先级：

// 云函数中FCM推送配置示例
const message = {
  data: {
    title: "通知标题",
    body: "通知内容",
    // 其他自定义数据
  },
  topic: "your_topic",
  android: {
    priority: "high", // 设置高优先级
  },
};

await admin.messaging().send(message);

5. 处理Android电池优化限制 #

部分国产ROM会限制应用后台网络连接，导致FCM消息无法及时接收：

• 在AndroidManifest.xml中添加权限：

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

• 在应用启动时请求忽略电池优化：

  import 'package:android_intent_plus/android_intent.dart';
  import 'package:flutter/services.dart';
  
  void requestIgnoreBatteryOptimizations() async {
    if (Platform.isAndroid) {
      try {
        final intent = AndroidIntent(
          action: 'android.settings.REQUEST_IGNORE_BATTERY_OPTIMIZATIONS',
          data: Uri.parse('package:${await getPackageName()}'),
        );
        await intent.launch();
      } on PlatformException catch (e) {
        // 处理异常
      }
    }
  }
  

6. 确认Firebase Messaging初始化时机 #

确保Firebase.initializeApp()在应用启动时尽早执行，且在所有FCM相关操作（Token获取、主题订阅）之前完成。

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