如何在Android Studio中修改Java路径？解决javaHome无效报错

错误场景 #

构建时出现如下错误：

正在SM A127F设备上以调试模式启动lib\main.dart...
正在执行Gradle任务'assembleDebug'...

FAILURE: 构建过程中出现异常导致失败。

* 问题原因：
提供的javaHome似乎无效，无法找到java可执行文件。尝试的路径：C:\Program Files\Java\jdk-21\bin\java.exe

* 解决建议：
> 使用--stacktrace选项获取堆栈跟踪信息。
> 使用--info或--debug选项获取更多日志输出。
> 使用--scan选项获取完整分析信息。

* 如需更多帮助，请访问https://help.gradle.org

解决步骤 #

• 确认JDK路径有效性
  先检查报错路径C:\Program Files\Java\jdk-21\bin\java.exe是否实际存在。若不存在，要么安装对应版本JDK，要么切换到已安装的、Gradle兼容的JDK版本（推荐JDK 17，多数Android项目和Gradle版本适配性更好）。

• 在Android Studio内配置JDK

  1. 打开Android Studio，按快捷键Ctrl+Alt+Shift+S打开项目结构窗口
  2. 左侧选择SDK Location，找到JDK Location选项
  3. 点击路径旁的文件夹图标，选择正确的JDK根目录（例如C:\Program Files\Java\jdk-17，不要选到bin目录或java.exe）
  4. 点击Apply和OK保存配置

• 修改项目Gradle配置（全局配置不生效时）
  打开项目根目录下的gradle.properties文件，添加或修改以下配置：

  org.gradle.java.home=C:\\Program Files\\Java\\jdk-17
  

  路径需使用双反斜杠\\或正斜杠/分隔。

• 检查系统环境变量

  1. 右键「此电脑」→「属性」→「高级系统设置」→「环境变量」
  2. 确认JAVA_HOME变量指向正确的JDK根目录，Path变量中包含该JDK的bin目录
  3. 若存在多个JDK，调整环境变量优先级，确保Android Studio调用的是指定版本

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