Flutter Android项目解析dev.flutter.flutter-plugin-loader插件失败如何解决？

架构老林

2026-6-16

解决Flutter项目Gradle插件解析失败（metadata.bin无法读取）的问题

以下是针对你遇到的dev.flutter.flutter-plugin-loader插件解析失败、无法读取metadata.bin文件的可行解决步骤：

清理Gradle全局缓存
直接删除Gradle缓存目录里的损坏文件，Mac终端执行命令：
```
rm -rf ~/.gradle/caches/8.10/kotlin-dsl/accessors/988977859d9b6b0195278c1d04431d6c/
```
如果不确定具体目录，也可以清空整个缓存：
```
rm -rf ~/.gradle/caches/
```
执行完后重新运行flutter run。
重置IDE缓存并重启
打开Android Studio，依次点击File > Invalidate Caches...，选择Invalidate and Restart，让IDE重新生成所有缓存文件和索引。
修复Gradle目录权限
可能是缓存目录权限不足导致无法读取文件，终端执行命令修改所有者权限：
```
chown -R $USER:$USER ~/.gradle
```
确保当前用户对.gradle目录有完整的读写权限。
同步并重新生成项目Gradle配置
进入项目的android目录，执行：
```
./gradlew clean
./gradlew assembleDebug
```
完成后回到项目根目录运行flutter run。
检查Gradle版本兼容性
确认项目android/build.gradle中classpath的Gradle插件版本，以及gradle/wrapper/gradle-wrapper.properties中的Gradle发行版版本，和你当前使用的Flutter SDK版本兼容。比如Flutter 3.16+建议搭配Gradle 8.0+版本。