Gradle构建失败:Flutter插件解析失败及项目配置路径异常求助
问题分析与解决方法
错误原因拆解
dev.flutter.flutter-plugin-loader:1.0.0解析失败- 大概率是项目Gradle配置缺失Flutter本地Maven仓库引用,导致Gradle找不到这个Flutter内置插件;或是Flutter SDK内部的plugin-loader组件损坏、缺失。
- 「无法将临时工作区移动到不可变位置」
- 核心原因是Gradle缓存目录权限不足,或缓存目录所在磁盘为只读状态;也可能是Gradle临时文件路径被配置到了系统只读区域。
分步解决方法
先处理「临时工作区移动」问题
- 检查并修复Gradle缓存目录权限
- Windows:找到
C:\Users\<你的用户名>\.gradle,右键→属性→取消「只读」勾选,确认当前用户拥有读写权限。 - macOS/Linux:终端执行
chmod -R 755 ~/.gradle,赋予缓存目录读写执行权限。
- Windows:找到
- 手动指定可写的Gradle缓存目录
在项目根目录的gradle.properties文件中添加以下配置,替换为你有完全读写权限的路径:org.gradle.caching.dir=/Users/xxx/custom-gradle-cache # macOS/Linux示例 # org.gradle.caching.dir=D:\custom-gradle-cache # Windows示例
再解决插件解析失败问题
- 验证并修复Flutter SDK完整性
- 终端执行
flutter doctor -v,检查是否有SDK组件缺失提示,若有则执行flutter doctor --android-licenses完成授权,再执行flutter upgrade --force强制修复SDK。 - 手动检查Flutter SDK内的plugin-loader文件:找到Flutter安装路径下的
packages/flutter_tools/gradle/flutter-plugin-loader-1.0.0.jar,若文件不存在,重新下载解压Flutter SDK。
- 终端执行
- 修复项目Gradle仓库配置
打开项目根目录的android/build.gradle,确保buildscript和allprojects块中添加Flutter本地Maven仓库:buildscript { repositories { google() mavenCentral() // 替换为你的Flutter SDK绝对路径 maven { url "D:/flutter/packages/flutter_tools/gradle" } } dependencies { classpath "com.android.tools.build:gradle:7.4.2" classpath "dev.flutter:flutter-gradle-plugin:1.0.0" } } allprojects { repositories { google() mavenCentral() maven { url "D:/flutter/packages/flutter_tools/gradle" } } } - 彻底清理Gradle缓存并刷新依赖
- 删除用户目录下的
.gradle/caches和.gradle/wrapper文件夹。 - 进入项目
android目录,执行./gradlew clean,再执行./gradlew build --refresh-dependencies强制刷新所有依赖。
- 删除用户目录下的
- 检查项目插件引用配置
打开android/app/build.gradle,确保文件开头包含:
注意不要手动添加apply plugin: 'com.android.application' apply plugin: 'dev.flutter.flutter-gradle-plugin'flutter-plugin-loader的依赖,该插件由flutter-gradle-plugin自动管理。
内容的提问来源于stack exchange,提问作者シAryam
相关产品推荐
相关产品推荐

