Flutter使用just_audio插件点击按钮报MissingPluginException如何解决

报错原因 #

该错误属于Flutter平台插件的通用报错，触发核心是运行时just_audio的平台侧原生实现未正确注册，方法通道的调用链路断裂，常见触发场景如下：

• 执行flutter pub get添加依赖后，直接通过热重载/热更新加载应用，没有重新编译完整的原生部分代码
• Flutter SDK版本和当前使用的just_audio版本不兼容
• 项目构建缓存冲突，旧的构建产物中没有包含just_audio的原生实现代码
• 若在Web/桌面端运行，没有安装just_audio对应平台的适配依赖

解决步骤 #

• 首先停止当前运行的应用，执行如下命令清理缓存、重新拉取依赖：

flutter clean
flutter pub get

• 完全重新构建安装应用，不要使用热重载/热更新，直接冷启动运行
• 若操作后仍报错，检查版本适配：对照just_audio官方版本说明，匹配当前项目的Flutter SDK版本，升级到兼容的稳定版即可；如果运行在Web/桌面端，额外安装对应平台的适配包，比如Web端安装just_audio_web、Windows端安装just_audio_windows
• 针对iOS端额外适配：进入项目ios目录，执行pod deintegrate && rm Podfile.lock清理旧的Pods依赖，再重新运行项目

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