JetBrains Fleet中Gradle JDK配置错误及配置方法

当你用JetBrains Fleet打开Java项目的build.gradle文件时，若遇到如下错误：

Invalid Gradle JDK configuration found. <a href='#open_external_system_settings'>Open Gradle Settings</a>

以及对应的异常栈信息：

com.intellij.openapi.externalSystem.service.execution.ExternalSystemJdkException: Invalid Gradle JDK configuration found. <a href='#open_external_system_settings'>Open Gradle Settings</a> 
    
        at org.jetbrains.plugins.gradle.service.execution.LocalGradleExecutionAware.jdkConfigurationException(LocalGradleExecutionAware.kt:184)
        at org.jetbrains.plugins.gradle.service.execution.LocalGradleExecutionAware.prepareJvmForExecution(LocalGradleExecutionAware.kt:122)
        at org.jetbrains.plugins.gradle.service.execution.LocalGradleExecutionAware.prepareExecution(LocalGradleExecutionAware.kt:62)
        at com.intellij.openapi.externalSystem.service.internal.ExternalSystemResolveProjectTask.doExecute(ExternalSystemResolveProjectTask.java:90)
        at com.intellij.openapi.externalSystem.service.internal.AbstractExternalSystemTask.execute(AbstractExternalSystemTask.java:151)
        at com.intellij.openapi.externalSystem.service.internal.AbstractExternalSystemTask.execute(AbstractExternalSystemTask.java:135)
        at com.intellij.openapi.externalSystem.util.ExternalSystemUtil$2.executeImpl(ExternalSystemUtil.java:496)
        at com.intellij.openapi.externalSystem.util.ExternalSystemUtil$2.lambda$execute$0(ExternalSystemUtil.java:327)
        at com.intellij.openapi.project.DumbServiceHeavyActivities.suspendIndexingAndRun(DumbServiceHeavyActivities.java:21)
        at com.intellij.openapi.project.DumbServiceImpl.suspendIndexingAndRun(DumbServiceImpl.java:186)
        at com.intellij.openapi.externalSystem.util.ExternalSystemUtil$2.execute(ExternalSystemUtil.java:327)
        at com.intellij.openapi.externalSystem.util.ExternalSystemUtil$4.run(ExternalSystemUtil.java:619)
        at com.intellij.openapi.progress.impl.CoreProgressManager.startTask(CoreProgressManager.java:424)
        at com.intellij.openapi.progress.impl.ProgressManagerImpl.startTask(ProgressManagerImpl.java:114)
        at com.intellij.openapi.progress.impl.CoreProgressManager.lambda$runProcessWithProgressAsynchronously$6(CoreProgressManager.java:475)
        at com.intellij.openapi.progress.impl.ProgressRunner.lambda$submit$3(ProgressRunner.java:252)
        at com.intellij.openapi.progress.impl.CoreProgressManager.lambda$runProcess$2(CoreProgressManager.java:188)
        at com.intellij.openapi.progress.impl.CoreProgressManager.lambda$executeProcessUnderProgress$13(CoreProgressManager.java:590)
        at com.intellij.openapi.progress.impl.CoreProgressManager.registerIndicatorAndRun(CoreProgressManager.java:665)
        at com.intellij.openapi.progress.impl.CoreProgressManager.computeUnderProgress(CoreProgressManager.java:621)
        at com.intellij.openapi.progress.impl.CoreProgressManager.executeProcessUnderProgress(CoreProgressManager.java:589)
        at com.intellij.openapi.progress.impl.ProgressManagerImpl.executeProcessUnderProgress(ProgressManagerImpl.java:60)
        at com.intellij.openapi.progress.impl.CoreProgressManager.runProcess(CoreProgressManager.java:175)
        at com.intellij.openapi.progress.impl.ProgressRunner.lambda$submit$4(ProgressRunner.java:252)
        at java.base/java.util.concurrent.CompletableFuture$AsyncSupply.run(CompletableFuture.java:1768)
        at java.base/java.util.concurrent.ThreadPoolExecutor.runWorker(ThreadPoolExecutor.java:1136)
        at java.base/java.util.concurrent.ThreadPoolExecutor$Worker.run(ThreadPoolExecutor.java:635)
        at java.base/java.util.concurrent.Executors$PrivilegedThreadFactory$1$1.run(Executors.java:702)
        at java.base/java.util.concurrent.Executors$PrivilegedThreadFactory$1$1.run(Executors.java:699)
        at java.base/java.security.AccessController.doPrivileged(AccessController.java:399)
        at java.base/java.util.concurrent.Executors$PrivilegedThreadFactory$1.run(Executors.java:699)
        at java.base/java.lang.Thread.run(Thread.java:833)

可以通过以下两种方式配置Gradle JDK：

方法一：通过Fleet设置面板配置 #

• 按下快捷键Cmd+,（Mac）或Ctrl+,（Windows/Linux）打开设置面板，也可点击右上角齿轮图标选择Settings。
• 在左侧导航栏展开Build, Execution, Deployment → Build Tools → Gradle。
• 在Gradle JVM下拉菜单中选择已安装的JDK版本；若列表中没有目标JDK，点击右侧的...按钮，手动定位到JDK安装目录添加。
• 注意选择的JDK版本需匹配项目Gradle要求（例如Gradle 8.x建议使用JDK 11及以上版本）。
• 点击面板右下角的Apply和OK，等待Fleet重新同步Gradle项目。

方法二：通过项目配置文件指定 #

• 在项目根目录的gradle.properties文件中添加一行配置：

  org.gradle.java.home=/path/to/your/jdk
  

• 将/path/to/your/jdk替换为JDK实际安装路径（比如Mac上的/Library/Java/JavaVirtualMachines/jdk-17.jdk/Contents/Home，Windows上的C:\Program Files\Java\jdk-17）。
• 保存文件后，重新触发Gradle同步即可。

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