Eclipse中遇到「无法连接Gradle分发版本运行构建操作」问题如何解决
报错核心诱因
- 版本硬兼容冲突:你配置的本地Gradle 4.3.1,和build脚本中引入的
com.github.jengelman.gradle.plugins:shadow:6.1.0完全不匹配。Shadow插件6.1.0最低要求Gradle 7.0以上版本运行,根本无法在2017年发布的Gradle 4.3.1环境下加载,这是触发「无法连接Gradle分发版本运行构建」报错的最常见原因。 - 项目配置覆盖全局设置:就算你在Eclipse全局首选项里指定了本地Gradle路径,Buildship插件会优先读取项目级的Gradle配置,如果项目里的
gradle/wrapper/gradle-wrapper.properties指定了远程拉取的Gradle版本,一旦网络无法连通对应仓库,就会直接抛出该报错。
分步排查修复操作
- 修正构建脚本的插件兼容配置
- 将buildscript块中的Shadow插件classpath依赖替换为适配Gradle 4.3.1的2.0.4版本,即修改为
classpath "com.github.jengelman.gradle.plugins:shadow:2.0.4" - 删除脚本中重复书写的两次
apply plugin: "com.github.johnrengelman.shadow"语句,仅在buildscript配置完成后保留一次apply操作即可,重复加载插件会引发构建中断 - 调整fatJar任务的依赖引入写法,适配2.x版本Shadow插件的API规则,避免任务定义阶段报错
- 将buildscript块中的Shadow插件classpath依赖替换为适配Gradle 4.3.1的2.0.4版本,即修改为
- 锁定项目级Gradle使用路径
- 右键项目打开属性设置面板,进入
Gradle配置页,将发行版来源从默认的「wrapper 配置获取」修改为「本地安装」,直接指定路径为c:\gradle-4.3.1,避免项目配置覆盖全局设置 - 检查项目根目录下是否存在
gradle/wrapper/gradle-wrapper.properties文件,如果存在,直接删除该文件,阻断Eclipse自动远程拉取其他版本Gradle的逻辑
- 右键项目打开属性设置面板,进入
- 清理失效缓存重新触发刷新
- 关闭Eclipse,找到本地Gradle缓存目录(Windows系统默认路径为
C:\Users\你的用户名\.gradle\caches),删除目录中已损坏的插件缓存、旧版本Gradle元数据 - 重启Eclipse后,重新执行右键菜单
Gradle > Refresh Gradle Project操作即可完成项目加载
- 关闭Eclipse,找到本地Gradle缓存目录(Windows系统默认路径为
注意:不要直接将Eclipse Gradle配置改成自动匹配脚本里的插件版本要求,否则会自动下载远高于4.3.1的Gradle版本,反而和你本地搭建的运行环境不匹配。
内容的提问来源于stack exchange,提问作者Aamer Sohail Chaudhary
相关产品推荐
相关产品推荐

