Gradle 8.3兼容JDK版本疑问：IntelliJ提示JDK20.0.2不兼容如何解决？

1. 检查IntelliJ项目级JDK配置 #

• 打开项目结构（快捷键Ctrl+Alt+Shift+S），进入Project Settings > Project，确认Project SDK是JDK 20.0.2，Project language level设置为20（匹配JDK版本的语言级别）。
• 切换到Modules选项卡，确保每个模块的Module SDK都与项目SDK保持一致。

2. 修正Gradle的JVM配置 #

• 在IntelliJ右侧打开Gradle面板，右键点击你的项目，选择Gradle Settings。
• 在Build, Execution, Deployment > Build Tools > Gradle路径下，检查Gradle JVM选项：
  • 选择Use JDK from project structure，确认其指向的是JDK 20.0.2；
  • 也可以直接指定JDK 20的安装路径，避免依赖系统环境变量的不确定性。

3. 验证系统与IDE的JAVA_HOME一致性 #

• 打开系统终端（Windows用CMD/PowerShell，Mac/Linux用Terminal），执行echo %JAVA_HOME%（Windows）或echo $JAVA_HOME（Mac/Linux），确认输出路径是JDK 20.0.2的安装目录。
• 如果系统的JAVA_HOME路径错误，修改系统环境变量指向正确路径；如果系统路径正确但IDE未识别，重启IntelliJ并通过File > Invalidate Caches...勾选Clear file system cache and local history后重启，让IDE重新加载环境变量。

4. 强制Gradle使用指定JDK #

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

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

  将/path/to/your/jdk20替换为你实际的JDK 20安装路径，这样Gradle会直接使用该JDK，不受系统或IDE默认配置影响。

5. 清理缓存并重新构建 #

• 执行File > Invalidate Caches... > Invalidate and Restart，清空IDE缓存。
• 删除项目根目录下的.gradle文件夹和所有模块的build文件夹，然后在终端或IntelliJ的Gradle面板中运行gradle clean build，让Gradle重新生成缓存和构建文件。

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