Android Studio报错：JAVA_HOME指向无效目录，修改后仍未解决

问题描述 #

• 报错信息：

ERROR: JAVA_HOME is set to an invalid directory: /usr/lib/jvm/openjdk-11

Please set the JAVA_HOME variable in your environment to match the
location of your Java installation.

Exception: Gradle task assembleDebug failed with exit code 1

• 复现流程：
  1. 触发上述编译报错
  2. 确认/usr/lib/jvm/openjdk-11路径无效
  3. 修改系统默认JAVA_HOME至有效JDK路径
  4. 重新编译仍出现相同报错，提示路径还是旧的无效目录

解决方案 #

1. 检查Android Studio自身JDK配置 #

Android Studio默认可能使用内置JDK，不依赖系统环境变量：

• 打开Android Studio，进入 File > Project Structure > SDK Location
• 查看JDK location选项，将其改为你的有效JDK路径（比如/usr/lib/jvm/openjdk-17）
• 点击Apply后，执行右上角的Sync Project with Gradle Files

2. 排查项目gradle.properties的硬编码配置 #

项目可能单独指定了JDK路径：

• 打开项目根目录的gradle.properties文件
• 查找org.gradle.java.home配置项，若存在则修改为有效路径：

org.gradle.java.home=/usr/lib/jvm/你的有效JDK路径

• 保存后重新同步项目

3. 确保系统环境变量生效 #

修改系统JAVA_HOME后，需确认当前会话已读取新变量：

• 若通过终端启动Android Studio，关闭所有终端窗口，重新打开后执行echo $JAVA_HOME验证路径正确，再从该终端启动IDE
• 图形界面启动的话，重启系统让全局环境变量生效

4. 清除Gradle缓存 #

Gradle守护进程可能缓存了旧的环境信息：

• 关闭Android Studio
• 删除~/.gradle/caches目录
• 重启IDE并同步项目

5. 验证系统环境变量配置文件 #

确保修改了正确的配置文件（以Linux为例）：

• 编辑~/.bashrc（或~/.zshrc，取决于你使用的shell），添加：

export JAVA_HOME=/usr/lib/jvm/你的有效JDK路径
export PATH=$JAVA_HOME/bin:$PATH

• 执行source ~/.bashrc使修改生效，再用echo $JAVA_HOME确认路径正确

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