Firebase后台消息中MethodChannel调用MissingPluginException问题排查

核心原因 #

后台接收Firebase通知时，Flutter引擎通常未完成初始化；或者你仅在Flutter页面启动时注册了方法通道，导致后台进程中通道未注册，进而触发异常。

具体解决方案 #

1. 将方法通道移至Application级别初始化 #

不要仅在FlutterActivity/FlutterFragment的生命周期方法中注册通道，改为在自定义的Application类中完成初始化，确保后台进程启动时通道已存在。

Kotlin示例代码：

class MyApp : Application() {
    lateinit var methodChannel: MethodChannel

    override fun onCreate() {
        super.onCreate()
        // 用全局上下文初始化MethodChannel
        methodChannel = MethodChannel(FlutterMain.findAppBundlePath(), "com.channel/method")
        methodChannel.setMethodCallHandler { call, result ->
            when (call.method) {
                "triggerAlarm" -> {
                    // 执行你的原生闹钟逻辑
                    result.success("Alarm triggered successfully")
                }
                else -> result.notImplemented()
            }
        }
    }
}

记得在AndroidManifest.xml中配置这个自定义Application：

<application
    android:name=".MyApp"
    android:icon="@mipmap/ic_launcher"
    android:label="Your App">
    <!-- 其他配置 -->
</application>

2. 后台通知处理时手动初始化Flutter引擎 #

如果Firebase通知是在FirebaseMessagingService中处理的，需要手动初始化并绑定Flutter引擎，保证通道能正常通信。

Kotlin示例（在FirebaseMessagingService中处理）：

class MyFirebaseMessagingService : FirebaseMessagingService() {
    override fun onMessageReceived(remoteMessage: RemoteMessage) {
        super.onMessageReceived(remoteMessage)
        
        // 初始化Flutter引擎
        val flutterEngine = FlutterEngine(this)
        flutterEngine.dartExecutor.executeDartEntrypoint(
            DartExecutor.DartEntrypoint.createDefault()
        )
        
        // 注册方法通道或直接获取Application中已注册的通道
        val methodChannel = MethodChannel(flutterEngine.dartExecutor.binaryMessenger, "com.channel/method")
        // 若需要让Flutter调用原生，此时通道已注册完成；也可直接在原生侧执行逻辑
        triggerAlarmDirectly()
    }

    private fun triggerAlarmDirectly() {
        // 直接编写触发闹钟的原生代码，无需通过Flutter通道转发
    }
}

3. 优先在原生侧处理后台通知逻辑 #

后台场景下，尽量避免通过Flutter通道跨层调用，直接在FirebaseMessagingService中处理通知触发的原生逻辑，既能避免通道问题，也能提升性能。

4. 检查通道注册时机 #

• 确认没有仅在MainActivity的onCreate中注册通道，后台进程启动时Activity不会被创建
• 确保通道注册代码在Application或Service的初始化阶段执行

额外验证项 #

• 执行flutter clean后，务必重新构建完整APK，不要用增量构建包测试
• 检查Firebase通知的优先级配置，后台接收需设置priority: high或包含notification字段
• 通过Logcat确认后台进程未被系统杀死，FirebaseMessagingService能正常接收通知

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