创建Kotlin项目时Gradle同步失败：ModuleVersionResolveException报错求助

云原生阿岚

2026-7-25

解决IntelliJ创建Kotlin项目时无法解析gradle:gradle:7.4.2的问题

检查Gradle仓库配置
打开项目根目录下的settings.gradle或settings.gradle.kts文件，确认已添加mavenCentral()、gradlePluginPortal()等官方仓库，示例配置如下：
```
pluginManagement {
    repositories {
        gradlePluginPortal()
        mavenCentral()
        google()
    }
}
dependencyResolutionManagement {
    repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
    repositories {
        mavenCentral()
        google()
    }
}
```
若缺少对应仓库，补充后点击IntelliJ工具栏的"Sync Project with Gradle Files"重新同步。
清理本地Gradle缓存
找到本地Gradle缓存目录：Windows为C:\Users\<你的用户名>\.gradle\caches，Mac/Linux为~/.gradle/caches，删除整个caches文件夹，之后回到IDE重新同步项目。
排查网络与代理问题
确保网络可正常访问Maven中央仓库，若处于受限网络环境，在IntelliJ中配置代理：打开File > Settings > Build, Execution, Deployment > Build Tools > Gradle，在"Gradle VM options"中添加代理参数：
```
-Dhttp.proxyHost=代理地址 -Dhttp.proxyPort=代理端口 -Dhttps.proxyHost=代理地址 -Dhttps.proxyPort=代理端口
```
配置完成后重新同步。
切换Gradle版本
若7.4.2版本持续无法解析，可尝试更换为其他稳定版本。打开gradle/wrapper/gradle-wrapper.properties文件，修改distributionUrl字段：
```
distributionUrl=https\://services.gradle.org/distributions/gradle-7.5-bin.zip
```
保存后重新同步项目。
检查IntelliJ的Gradle运行配置
打开File > Settings > Build, Execution, Deployment > Build Tools > Gradle，确认"Build and run using"和"Run tests using"均设置为"Gradle"，避免IDE内置配置与项目Gradle版本冲突。