Gradle无法构建Native Image：Sdkman安装GraalVM的配置问题

问题根源 #

Gradle Native插件检测GraalVM时，依赖GRAALVM_HOME的精确指向，以及JDK路径与GraalVM的直接关联。Sdkman通过current软链接管理JDK版本，可能导致插件无法正确识别GraalVM的实际安装路径。

解决方案 #

1. 修正GRAALVM_HOME指向实际路径 #

先通过以下命令找到GraalVM的真实安装目录：

readlink -f $(which gu) | sed 's/\/bin\/gu$//'

输出的路径就是GraalVM的根目录，比如/home/username/.sdkman/candidates/java/22.3.r17-grl。

修改环境变量（可写入~/.bashrc或~/.zshrc永久生效）：

export GRAALVM_HOME=/home/username/.sdkman/candidates/java/22.3.r17-grl
export PATH=$GRAALVM_HOME/bin:$PATH

重启终端后，执行echo $GRAALVM_HOME和gu --version确认配置生效。

2. 在Gradle构建脚本中指定GraalVM工具链 #

如果环境变量配置后仍无效，直接在构建脚本中明确指定GraalVM：

Groovy 版本（build.gradle）

graalvmNative {
    binaries {
        main {
            javaLauncher = javaToolchains.launcherFor {
                languageVersion = JavaLanguageVersion.of(17) // 替换为你的GraalVM Java版本
                vendor = JvmVendorSpec.matching("GraalVM Community")
            }
        }
    }
}

Kotlin 版本（build.gradle.kts）

graalvmNative {
    binaries {
        named("main") {
            javaLauncher.set(javaToolchains.launcherFor {
                languageVersion.set(JavaLanguageVersion.of(17))
                vendor.set(JvmVendorSpec.matching("GraalVM Community"))
            })
        }
    }
}

3. 确认native-image组件已安装 #

执行以下命令检查是否安装了native-image：

gu list

如果未找到，执行安装命令：

gu install native-image

4. 验证Gradle工具链配置 #

确保项目的settings.gradle（或settings.gradle.kts）配置了正确的仓库：

Groovy 版本（settings.gradle）

pluginManagement {
    repositories {
        gradlePluginPortal()
        mavenCentral()
    }
}

dependencyResolutionManagement {
    repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
    repositories {
        mavenCentral()
    }
}

完成以上配置后，重新执行./gradlew nativeCompile即可。

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