Flutter release包报MissingPluginException 双插件共存兼容问题

问题场景 #

• 仅在release构建模式下打包安装APK时触发固定报错：MissingPluginException(No implementation found for method checkPermissionStatus on channel flutter.baseflow.com/permissions/methods)
• 完全相同的业务代码、一致的插件组合，在debug模式下运行时所有权限申请、文件选择功能均正常，无任何异常触发
• 初步排查结论：同时集成file_picker与permission_handler两款插件时异常必现，单独移除任意一款插件后异常完全消失，但业务存在两个插件的刚需使用场景，无法通过单插件移除的方式规避问题

异常根因 #

该问题与Flutter debug/release模式的构建逻辑差异直接相关：

• release构建默认开启R8代码混淆、资源裁剪流程，缺失对应保留规则时，插件的原生实现类会被直接裁剪或修改类名，导致Flutter端方法通道无法匹配到对应的原生实现
• file_picker6.x及以上版本会传递依赖低版本permission_handler的实现，和项目直接集成的高版本permission_handler形成版本冲突，进一步放大了混淆裁剪带来的匹配失效问题
• debug模式默认关闭混淆与裁剪逻辑，因此相同代码下不会触发通道匹配失败的问题，这也是debug模式功能完全正常的核心原因

可落地解决方案 #

• 第一步：对齐插件兼容版本，消除传递依赖冲突
  在项目pubspec.yaml中指定两个插件的兼容版本组合，避免file_picker传递引入不兼容的低版本permission_handler：

  dependencies:
    permission_handler: ^11.3.1
    file_picker: ^8.0.0+1
  

  执行flutter pub upgrade同步依赖后，检查pubspec.lock中的permission_handler版本条目，确认不存在多版本并存的情况。
• 第二步：补充Android端混淆保留规则，避免插件实现类被裁剪
  打开项目下android/app/proguard-rules.pro配置文件，追加以下保留规则：

  # 保留permission_handler原生实现类
  -keep class com.baseflow.permissionhandler.** { *; }
  # 保留file_picker原生实现类
  -keep class com.mr.flutter.plugin.filepicker.** { *; }
  # 通用Flutter插件注册类保留规则
  -keep class io.flutter.plugin.** { *; }
  -keepclassmembers class * implements io.flutter.plugin.common.PluginRegistry {
    public static void registerWith(io.flutter.plugin.common.PluginRegistry);
  }
  

  确认android/app/build.gradle中release构建段已正确关联上述proguard规则文件，避免规则未生效：

  buildTypes {
    release {
        minifyEnabled true
        shrinkResources true
        proguardFiles getDefaultProguardFile('proguard-android-optimize.txt'), 'proguard-rules.pro'
    }
  }
  

• 第三步：清理缓存重新构建验证
  完成上述修改后，依次执行flutter clean清理历史构建缓存、flutter pub get重新拉取依赖，再执行flutter build apk --release生成最终安装包，安装后验证权限申请、文件选择功能的运行状态，确认异常不再触发

常见避坑提示 #

• 不建议直接通过dependency_overrides强制拉取最新版permission_handler覆盖file_picker的传递依赖，容易出现原生方法签名不匹配的运行时崩溃
• 若使用3.10以下版本的Flutter稳定SDK，需先升级SDK版本，老版本SDK存在release下插件自动注册逻辑遗漏的已知问题，会额外触发同类通道异常

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