Flutter中Firebase Cloud Message处理后台消息Android 5.1下崩溃咨询

核心原因 #

该崩溃是安卓5.1（API22）低版本系统与当前使用的Firebase依赖版本、初始化逻辑不兼容导致的，常见触发点包括初始化顺序错误、缺少Java8编译支持、Multidex未开启、依赖版本存在兼容bug。

可行修复步骤 #

• 步骤1：调整Firebase初始化与回调注册顺序
  原代码中未在main入口完成Firebase初始化就先注册后台消息回调，低版本安卓的后台isolate会因找不到Firebase实例崩溃。修正后的代码如下：

  Future<void> main() async {
    // 先初始化Flutter引擎
    WidgetsFlutterBinding.ensureInitialized();
    // 先完成Firebase全局初始化
    await Firebase.initializeApp();
    // 再注册后台消息回调
    FirebaseMessaging.onBackgroundMessage(_firebaseMessagingBackgroundHandler);
    runApp(MyApp());
  }
  
  Future<void> _firebaseMessagingBackgroundHandler(RemoteMessage message) async {
    // 仅在回调内使用Firebase其他服务时才需要重复初始化，仅处理FCM消息可省略该步骤
    print("Handling a background message: ${message.messageId}");
  }
  

• 步骤2：配置Android端编译参数
  安卓5.1默认未完全支持Java8语法与多dex加载，需要在android/app/build.gradle中添加如下配置：

  android {
      defaultConfig {
          // 保留原有其他配置，新增下面一行开启多dex支持
          multiDexEnabled true
      }
  
      compileOptions {
          // 新增Java8编译支持
          sourceCompatibility JavaVersion.VERSION_1_8
          targetCompatibility JavaVersion.VERSION_1_8
      }
  }
  
  dependencies {
      // minSdkVersion<=20时必须添加，API22可选择添加避免兼容问题
      implementation 'com.android.support:multidex:2.0.1'
  }
  

• 步骤3：降级Firebase依赖到兼容版本
  当前使用的firebase_messaging: ^10.0.8存在低版本安卓后台回调兼容bug，可将依赖替换为经过验证的稳定兼容版本：

  dependencies:
    firebase_core: ^1.6.0
    firebase_messaging: ^9.1.4
    firebase_analytics: ^8.2.0
  

  修改后执行flutter clean清除旧编译缓存，再重新编译运行即可。
• 步骤4：简化后台回调逻辑
  后台消息处理运行在独立isolate中，低版本安卓不支持在回调中调用需要Android上下文的原生API，尽量只在回调中做日志打印、通知展示等轻量操作。

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