Flutter安卓正式版MissingPluginException问题求助

问题现象 #

• 仅从应用商店下载的安卓正式版出现如下错误，调试版运行正常，且并非所有正式版实例都会触发：

I/flutter (20730): MissingPluginException(No implementation found for method listen on channel plugins.flutter.io/firebase_firestore/document/bd4e8cf9-3f97-4dc6-998c-0c53c3666889)
I/flutter (20730): #0      MethodChannel._invokeMethod (package:flutter/src/services/platform_channel.dart:165)
I/flutter (20730): <asynchronous suspension>
I/flutter (20730): #1      EventChannel.receiveBroadcastStream.<anonymous closure> (package:flutter/src/services/platform_channel.dart:506)
I/flutter (20730): <asynchronous suspension>

• 尝试降级cloud_firestore从3.2.0到2.0.0，问题未解决。

解决方案 #

1. 配置ProGuard规则避免混淆

正式版构建默认开启代码混淆，Firestore相关方法可能被误删。在android/app/proguard-rules.pro中添加以下规则：

-keep class io.flutter.plugins.firebase.firestore.** { *; }
-keep class com.google.firebase.firestore.** { *; }

2. 确保Firestore插件正确注册

如果自定义了MainActivity，需手动注册Firestore插件，避免正式版构建时插件未被初始化：

import io.flutter.embedding.android.FlutterActivity
import io.flutter.embedding.engine.FlutterEngine
import io.flutter.plugins.firebase.firestore.FirebaseFirestorePlugin

class MainActivity : FlutterActivity() {
    override fun configureFlutterEngine(flutterEngine: FlutterEngine) {
        super.configureFlutterEngine(flutterEngine)
        FirebaseFirestorePlugin.registerWith(flutterEngine.dartExecutor.binaryMessenger)
    }
}

3. 调整App Bundle拆分配置

若使用App Bundle发布，架构/资源拆分可能导致部分设备缺失Firestore插件。在android/app/build.gradle中禁用不必要的拆分：

android {
    // 其他配置...
    bundle {
        language { enableSplit = false }
        density { enableSplit = false }
        abi { enableSplit = false }
    }
}

4. 清理缓存后重新构建正式版

旧构建缓存可能导致异常，执行以下命令后重新打包：

flutter clean
flutter build appbundle --release

说明 #

降级cloud_firestore版本无效的原因是：该问题并非插件版本bug，而是正式版构建流程中的混淆、插件注册或构建配置问题，需从构建环节入手解决。

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