使用Kotlin与Compose Desktop时Gradle同步失败问题排查

搭建Kotlin与Compose Desktop项目时，Gradle同步抛出异常，提示找不到版本1.9.20的org.jetbrains.kotlin.jvm插件。

相关配置文件 #

build.gradle.kts 文件： #

import org.jetbrains.compose.desktop.application.dsl.TargetFormat

plugins {
    kotlin("jvm")
    id("org.jetbrains.compose")
}
group = "io.crypto"
version = "1.0-SNAPSHOT"
repositories {
    mavenCentral()
    maven("https://maven.pkg.jetbrains.space/public/p/compose/dev")
}
dependencies {
    implementation(compose.desktop.currentOs)
}
compose.desktop {
    application {
        mainClass = "MainKt"
        nativeDistributions {
            targetFormats(TargetFormat.Dmg, TargetFormat.Msi, TargetFormat.Deb)
            packageName = "CryptoGraph"
            packageVersion = "1.0.0"
        }
    }
}

setting.gradle.kts 文件： #

pluginManagement {
    repositories {
        google()
        gradlePluginPortal()
        maven("https://maven.pkg.jetbrains.space/public/p/compose/dev")
    }

    plugins {
        kotlin("jvm").version(extra["kotlin.version"] as String)
        id("org.jetbrains.compose").version(extra["compose.version"] as String)
    }
}

rootProject.name = "CryptoGraph"

gradle.properties 文件： #

org.gradle.jvmargs=-Xmx2048m -Dfile.encoding=UTF-8
kotlin.code.style=official
kotlin.version=1.9.20
compose.version=1.5.10

gradle-wrapper.properties 文件： #

distributionBase=GRADLE_USER_HOME
distributionPath=wrapper/dists
distributionUrl=https\\://services.gradle.org/distributions/gradle-8.3-bin.zip
zipStoreBase=GRADLE_USER_HOME
zipStorePath=wrapper/dists

错误信息： #

Build file '/home/mbunderline76/tick-viewer/CryptoGraph/build.gradle.kts' line: 3

Plugin [id: 'org.jetbrains.kotlin.jvm', version: '1.9.20'] was not found in any of the following sources:

* Try:
> Run with --info or --debug option to get more log output.
> Run with --scan to get full insights.
> Get more help at https://help.gradle.org.

* Exception is:
org.gradle.api.plugins.UnknownPluginException: Plugin [id: 'org.jetbrains.kotlin.jvm', version: '1.9.20'] was not found in any of the following sources:

- Gradle Core Plugins (plugin is not in 'org.gradle' namespace)
- Plugin Repositories (could not resolve plugin artifact 'org.jetbrains.kotlin.jvm:org.jetbrains.kotlin.jvm.gradle.plugin:1.9.20')
Searched in the following repositories:
Google
Gradle Central Plugin Repository
maven(https://maven.pkg.jetbrains.space/public/p/compose/dev)<83 internal lines>

环境信息： #

• IDE：IntelliJ Idea Ultimate 2023.3.2
• 本地Gradle版本：

------------------------------------------------------------
Gradle 7.2
------------------------------------------------------------

Build time:   2021-08-17 09:59:03 UTC
Revision:     a773786b58bb28710e3dc96c4d1a7063628952ad

Kotlin:       1.5.21
Groovy:       3.0.8
Ant:          Apache Ant(TM) version 1.10.9 compiled on September 27 2020
JVM:          16.0.1 (Private Build 16.0.1+9-Ubuntu-120.04)
OS:           Linux 6.2.0-39-generic amd64

1. Gradle版本兼容性问题：Kotlin 1.9.20要求Gradle版本至少为8.0，而本地使用的Gradle 7.2版本过低，无法正确解析和下载该版本的Kotlin插件。虽然项目配置了Gradle Wrapper使用8.3版本，但实际运行时可能默认调用了本地旧版Gradle。
2. 旧版Gradle插件解析限制：低版本Gradle对新插件的元数据格式支持有限，即使仓库配置正确，也可能无法找到高版本的Kotlin插件。

1. 强制使用Gradle Wrapper版本 #

在IntelliJ中配置项目使用Gradle Wrapper，确保运行环境与配置的8.3版本一致：

• 打开File → Settings → Build, Execution, Deployment → Build Tools → Gradle
• 在Use Gradle from选项中选择Gradle wrapper
• 点击Apply和OK后，重新同步项目

2. 清理Gradle缓存 #

旧缓存可能导致插件解析异常，执行以下操作清理缓存：

• 删除本地Gradle缓存目录：~/.gradle/caches（Linux/macOS）或C:\Users\<你的用户名>\.gradle\caches（Windows）
• 在IntelliJ中点击File → Invalidate Caches...，选择Invalidate and Restart

3. 验证版本兼容性（可选） #

Compose 1.5.10官方兼容Kotlin 1.9.20，当前版本配置无需调整。

4. 手动更新本地Gradle（可选） #

如果偏好使用本地Gradle，可手动下载并安装Gradle 8.3版本，确保本地环境版本与项目配置一致。

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