首次使用Android Studio遇Gradle项目同步失败但版本匹配该如何修复
Gradle 6.9.1版本匹配下Gradle Project Sync failed修复方案
- 清理IDE缓存重启:依次点击顶部菜单栏
File→Invalidate Caches...,在弹出窗口勾选Clear file system cache and local history,点击Invalidate and Restart,等待IDE重启后重新触发项目同步。 - 替换国内镜像源解决网络访问问题:打开项目根目录下的
build.gradle文件,修改allprojects→repositories配置块,优先使用阿里云镜像,参考配置如下:
allprojects { repositories { maven { url 'https://maven.aliyun.com/repository/public' } maven { url 'https://maven.aliyun.com/repository/google' } maven { url 'https://maven.aliyun.com/repository/gradle-plugin' } google() mavenCentral() } }
修改完成后重新触发Gradle同步。
- 手动放置Gradle安装包避免下载超时:直接下载gradle-6.9.1-bin.zip压缩包(无需解压),放入当前系统用户目录下的
.gradle/wrapper/dists/gradle-6.9.1-bin/内的随机字符串命名文件夹中,重启Android Studio后重新同步。 - 核对AGP版本适配性:Gradle 6.9.1要求配套的Android Gradle Plugin版本范围为4.2.0 ≤ 版本 ≤ 7.0.4,打开项目根目录
build.gradle,查看dependencies块内com.android.tools.build:gradle后的版本号是否符合要求,不匹配则修改为对应范围内的版本后重新同步。 - 关闭Gradle离线模式:点击右侧边栏的Gradle面板,查看顶部工具栏的Toggle Offline Mode按钮是否开启,若处于开启状态则点击关闭后重新同步。
内容的提问来源于stack exchange,提问作者MrBigboka
相关产品推荐
相关产品推荐

