Flutter应用接入Firebase Messaging仅Android Release版收消息崩溃

从错误日志的IllegalAccessError和混淆后的类名特征来看，该问题由Release构建阶段的代码压缩/混淆配置缺失导致，Debug模式默认关闭混淆因此无异常，你可以按以下顺序排查遗漏配置：

1. 缺失Firebase相关混淆规则 #

Release构建默认开启R8混淆时，如果没有配置Firebase相关类的免混淆规则，会导致类被错误重命名、移除，触发访问权限异常。

• 找到android/app/proguard-rules.pro文件，添加以下规则：

# Firebase 全家桶免混淆规则
-keep class com.google.firebase.** { *; }
-keep class com.google.android.gms.** { *; }
-keep class io.flutter.plugins.firebase.messaging.** { *; }

# 如果你使用了自定义通知/消息解析类，也需要添加对应类的免混淆规则
-keep class 你的自定义消息类包名.** { *; }

• 检查android/app/build.gradle中Release构建配置是否正确关联了混淆文件：

android {
    // ...其他配置
    buildTypes {
        release {
            // 开启混淆压缩必须配置正确的proguardFiles
            minifyEnabled true
            shrinkResources true
            proguardFiles getDefaultProguardFile('proguard-android-optimize.txt'), 'proguard-rules.pro'
        }
    }
}

你可以先临时把minifyEnabled改为false打Release包验证，如果不再崩溃即可确定是混淆配置问题。

2. AndroidManifest.xml配置缺失 #

检查android/app/src/main/AndroidManifest.xml中是否遗漏了必要配置：

• 必备基础权限：

<!-- 网络访问权限 -->
<uses-permission android:name="android.permission.INTERNET" />
<!-- Android 13及以上通知权限 -->
<uses-permission android:name="android.permission.POST_NOTIFICATIONS" />

• 确认你没有覆盖Firebase Messaging自动注入的服务、intent filter配置，如果你手动修改过消息服务相关配置，需要和firebase_messaging插件官方要求对齐。

3. 依赖版本不兼容 #

• 检查pubspec.yaml中firebase_core和firebase_messaging版本匹配，不要跨大版本混用
• 检查android/build.gradle中google-services插件版本不要过旧，推荐使用4.3.15及以上版本：

dependencies {
    classpath 'com.google.gms:google-services:4.3.15'
    // ...其他依赖
}

• 确认google-services.json文件已正确放置在android/app目录下，且Release打包时被正确包含。

4. 后台消息处理逻辑配置缺失 #

如果你使用了onBackgroundMessage后台消息回调：

• 回调函数必须是顶级静态函数，不能是类的实例方法
• 如果你在回调中调用了其他Flutter插件，需要确保后台回调中正确初始化了Flutter引擎，旧版本插件需要手动在Android原生层做初始化配置。

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