Gradle无法安装未解析依赖，点击同步项目后仍无响应求排查

我之前也碰到过一模一样的问题，折腾了好一阵才理清各种可能的原因，给你列几个最常见的：

• 网络连接受限：这是最普遍的诱因。Gradle默认依赖Maven Central、Google这类远程仓库拉取资源，如果你的网络有防火墙拦截、代理配置错误，或者网络波动大超时，请求根本发不出去，按钮自然没反应。比如公司内网屏蔽外部仓库、代理地址/端口填错，部分地区访问官方仓库速度过慢都可能触发这个问题。

• 仓库配置错误：你的build.gradle（或settings.gradle）里的仓库声明可能存在问题。比如漏加了必要仓库（比如Google仓库是很多Android依赖的唯一来源）、仓库地址拼写错误，或者依赖的仓库已经下线。举个例子，如果你要拉取com.google.android.material:material，但没配置google()仓库，Gradle根本找不到这个依赖，点击安装按钮也没用。

• Gradle本地缓存损坏：Gradle会把下载过的依赖存在本地缓存目录（默认是~/.gradle/caches），如果缓存文件损坏、部分缺失，会导致Gradle无法正确识别依赖状态，同步时卡在原地无响应。这种情况清理缓存通常能解决问题。

• 权限不足：如果项目目录或Gradle缓存目录没有读写权限，Gradle无法写入新的依赖文件，也会导致操作无响应。比如Linux/macOS下用sudo启动IDE、Windows下文件夹设为只读，都可能出现这类问题。

• 依赖本身不存在或版本错误：你声明的依赖groupId、artifactId或者版本号写错了，目标仓库里根本没有对应资源。这种情况下点击安装按钮毫无意义，因为仓库里找不到可下载的内容。比如把com.squareup.retrofit2:retrofit:2.9.0写成com.squareup.retrofit:retrofit:2.9.0，少了个2就会找不到依赖。

• IDE与Gradle版本不兼容：如果使用的IDE（比如Android Studio）版本过旧，和项目里的Gradle版本不匹配，可能出现同步逻辑的bug，导致按钮点击后无响应。比如用Android Studio Arctic Fox搭配Gradle 7.5，就可能存在兼容性冲突。

• 代理配置冲突：IDE的代理设置和系统代理冲突，或者gradle.properties里的代理配置与IDE设置不一致，都会导致请求被拦截或无法正确发送。比如IDE开了代理但Gradle配置里没启用，或者反过来，都会让依赖拉取失败。

内容的提问来源于stack exchange，提问作者Mohammad Haidar