Gradle忽略JAVA_HOME改用Android Studio JBR的问题求助

问题背景 #

在macOS（Apple Silicon）环境下，Gradle 9.4.1 + Kotlin 2.3.0项目中：

• .idea/gradle.xml已配置<option name="gradleJvm" value="#JAVA_HOME" />
• JAVA_HOME指向/Library/Java/JavaVirtualMachines/amazon-corretto-21.jdk/Contents/Home/bin
• Gradle Doctor报告Gradle使用Android Studio自带JBR，但终端运行./gradlew -version显示使用Amazon Corretto 21

疑问解答 #

1. 为什么Android Studio会忽略#JAVA_HOME？ #

核心原因有两个：

• JAVA_HOME路径错误：你的JAVA_HOME指向了bin子目录，正确的JAVA_HOME应该是JDK的根目录（即/Library/Java/JavaVirtualMachines/amazon-corretto-21.jdk/Contents/Home），Android Studio无法识别错误的路径，因此 fallback到默认JBR。
• IDE配置优先级：Android Studio的项目结构（Project Structure）中的Gradle JDK配置优先级高于.idea/gradle.xml的手动编辑内容，若你未在UI中明确指定，IDE可能不会读取xml中的配置。

2. 为什么它要使用自带的JBR？ #

JetBrains Runtime（JBR）是Android Studio官方定制的JDK，针对IDE的UI渲染、插件兼容性、性能做了专门优化。默认情况下，当IDE无法找到有效配置的JDK时，会自动切换到自带JBR，确保IDE和Gradle任务能正常运行。此外，Android Studio的部分核心功能依赖JBR的特定修改，官方也推荐使用它作为IDE的运行环境。

3. 这是预期行为吗？ #

不算正常预期的正确行为。如果你的JDK配置正确，Android Studio应该遵循#JAVA_HOME的设置；当前情况是因为配置错误（路径问题）导致IDE fallback到默认JBR，属于异常情况。

4. 如何让Gradle始终一致地使用JAVA_HOME？ #

按以下步骤操作：

1. 修正JAVA_HOME路径
   打开终端，编辑shell配置文件（_/.zshrc或/.bashrc），添加或修改：

   export JAVA_HOME=/Library/Java/JavaVirtualMachines/amazon-corretto-21.jdk/Contents/Home
   export PATH=$JAVA_HOME/bin:$PATH
   

   执行source ~/.zshrc（对应你的shell）使配置生效，重启Android Studio。

2. 在Android Studio中手动配置Gradle JDK

   • 打开File > Project Structure（快捷键Cmd + ;）
   • 切换到SDK Location标签，找到Gradle Settings区域的Gradle JDK选项
   • 选择Use JAVA_HOME，或者直接从列表中选中你的Amazon Corretto 21
   • 点击Apply和OK，等待项目同步完成

3. 清除Gradle缓存

   • 删除项目根目录下的.gradle文件夹
   • 删除用户目录下的~/.gradle/caches文件夹
   • 重启Android Studio并重新同步项目

4. 验证结果
   同步完成后，运行Gradle Doctor检查，或在IDE内置终端执行./gradlew -version，确认Launcher JVM和Runtime JVM均为Amazon Corretto 21。

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