IntelliJ无法解析本地Gradle版本问题求助

核心问题分析 #

从错误堆栈看，即便你已配置本地Gradle的distributionUrl为本地文件路径，Gradle仍尝试远程请求https://services.gradle.org/distributions/gradle-8.2.1-src.zip。这是因为Gradle Wrapper默认开启的分发包验证机制，会远程校验包的完整性，而公司网络限制导致无法访问该域名。

解决方案 #

1. 关闭Gradle Wrapper的分发包验证 #

修改gradle-wrapper.properties文件，将validateDistributionUrl设置为false：

distributionBase=GRADLE_USER_HOME
distributionPath=wrapper/dists
distributionUrl=file\:///C:/Gradle/gradle-8.2.1-bin.zip
networkTimeout=10000
validateDistributionUrl=false  # 改为false
zipStoreBase=GRADLE_USER_HOME
zipStorePath=wrapper/dists

修改后Gradle不会再远程验证本地分发包，直接使用你指定的本地zip文件。

2. 强制使用本地安装的Gradle（绕过Wrapper） #

在IntelliJ中直接配置使用本地Gradle安装目录，完全避免Wrapper的远程请求：

• 打开File → Settings → Build, Execution, Deployment → Build Tools → Gradle
• 在Gradle project下拉选择你的项目
• 选择Use local Gradle distribution，在Gradle home中填写本地Gradle的安装路径（例如C:/Gradle/gradle-8.2.1）
• 点击Apply和OK，重新同步项目

3. 验证操作 #

修改配置后，执行gradlew.bat clean build（Windows环境）或./gradlew clean build（Linux/Mac环境），检查是否还会出现UnknownHostException错误。

内容的提问来源于stack exchange，提问作者Nurtay Tulegenov