如何在IntelliJ中为不同Gradle项目管理多版本Java

问题根源 #

Gradle 6.7属于较旧版本，其内部编译逻辑未适配Java 17的模块系统（JDK 9+引入），当用Java 17启动Gradle进程时，会触发模块访问权限错误（jdk.compiler模块未向Gradle的未命名模块暴露内部类）。而IntelliJ能正常构建，是因为它为每个项目单独指定了运行Gradle的JDK，和系统JAVA_HOME无关。

推荐解决方案 #

1. 为项目单独配置Gradle运行JDK（最便捷） #

直接在项目根目录的gradle.properties文件中添加以下配置，指定该项目使用Java 11运行Gradle：

org.gradle.java.home=/Library/Java/JavaVirtualMachines/amazon-corretto-11.jdk/Contents/Home

之后在终端执行./gradlew build时，Gradle会自动使用指定的Java 11启动，无需手动修改环境变量。

如果不想修改项目文件，也可以在执行构建时临时传递参数：

./gradlew build -Dorg.gradle.java.home=/Library/Java/JavaVirtualMachines/amazon-corretto-11.jdk/Contents/Home

2. 使用版本管理工具自动切换（长期维护首选） #

安装SDKMAN!或jEnv这类多版本JDK/构建工具管理工具，实现进入项目目录自动切换对应版本：

• SDKMAN!示例：在Java 11项目根目录创建.sdkmanrc文件：

  java=11.0.23-amzn
  gradle=6.7
  

  进入项目目录时，SDKMAN!会自动切换到配置的Java和Gradle版本，直接执行./gradlew build即可正常构建。

3. 临时修改终端环境变量（应急方案） #

在终端执行构建前临时设置JAVA_HOME，仅对当前终端会话生效：

export JAVA_HOME=/Library/Java/JavaVirtualMachines/amazon-corretto-11.jdk/Contents/Home
./gradlew build

此方案繁琐，适合临时测试，不推荐日常使用。

4. 修改gradle-wrapper.properties（不推荐） #

虽然可以在gradle-wrapper.properties中添加org.gradle.java.home参数，但该文件主要用于指定Gradle wrapper版本，且硬编码的JDK路径在团队协作时可能因环境差异导致问题，因此不建议采用。

关键说明 #

Gradle的运行JDK（启动Gradle进程的JDK）和项目的源/目标兼容性是两个独立概念：

• 运行JDK需匹配Gradle版本要求（Gradle 6.7最高支持Java 15，因此必须用Java 11运行）
• 源/目标兼容性仅控制编译输出的字节码版本，不影响Gradle自身的运行环境

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