Flutter使用ext_storage保存CSV至Downloads目录报MissingPluginException错误

该异常的核心触发逻辑为Flutter侧通过平台通道调用原生方法时，原生层未注册对应插件实现，与ext_storage库的桥接状态、平台配置直接相关，可按以下优先级逐一排查修复：

• 第一步：清除构建缓存后全量重新安装应用
  多数同类型MissingPluginException是新增依赖后仅做热重载/热重启导致的——热重载不会重新初始化原生层的插件桥接，必须完全重新安装应用才能完成插件注册。操作流程：
  1. 完全终止设备上运行的目标应用
  2. 终端执行flutter clean清理所有历史构建缓存
  3. 重新执行flutter run全量构建并安装应用
• 第二步：解决ext_storage ^1.0.3版本的兼容问题
  该版本存在原生实现注册不完整的已知问题，在部分Android高版本工程中无法正常注册getExternalStoragePublicDirectory方法的桥接逻辑，可选择两种方案规避：
  • 方案1：移除存在兼容问题的ext_storage依赖，改用基础逻辑直接定位Downloads目录，减少第三方插件依赖带来的桥接故障，对应替换原目录获取的代码逻辑：

    // 替换ExtStorage的目录获取逻辑
    String downloadsPath = '/storage/emulated/0/Download';
    String targetFilePath = "$downloadsPath/maillist.csv";
    File f = File(targetFilePath);
    String csv = const ListToCsvConverter().convert(rows);
    await f.writeAsString(csv);
    

  • 方案2：保留ext_storage依赖的情况下，核对Android工程配置：确认android/app/build.gradle中minSdkVersion不低于21，Application清单文件未做拦截插件自动注册的自定义配置，确保原生层能正常加载插件实现。
• 第三步：修正原代码中的运行时隐患
  原实现存在几处容易触发后续运行问题的逻辑偏差，需同步调整：
  • 权限申请逻辑优化：原代码中发起权限申请后未等待授权流程完成就直接校验权限状态，容易出现误判。改为直接接收权限申请的返回值判断状态：

    PermissionStatus authStatus = await SimplePermissions.requestPermission(
        Permission.WriteExternalStorage
    );
    if (authStatus != PermissionStatus.granted) {
      // 权限不足时直接中断流程，给出提示
      return;
    }
    

  • 补全异步操作等待：原代码中f.writeAsString(csv)未添加await，容易出现文件未完成写入就退出流程的问题，需补充异步等待逻辑。
  • 移除循环内的无效setState：在遍历构建CSV行数据的循环中执行setState属于无意义的性能消耗，且循环内的mailList = finalExport赋值逻辑与导出流程完全脱节，需将状态更新逻辑移到文件写入操作全部完成后再执行。

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