Windows下Android Studio执行gradlew构建报JAVA_HOME未设置问题咨询

问题排查与解决方案 #

1. JAVA_HOME路径选择 #

你配置的C:\Program Files\Android\Android Studio\jre完全符合要求，甚至更推荐使用Android Studio自带的JRE/JDK：这个版本是官方针对Android构建流程适配的，不会出现Gradle插件和JDK版本不兼容的问题，不需要额外安装系统版JDK。

2. 已配置JAVA_HOME仍报错的排查 #

该报错是环境变量生效范围或配置格式问题导致，按以下步骤排查即可：

• 重启对应终端窗口：环境变量修改后，已经打开的cmd、Android Studio内置终端都不会自动读取新配置，必须完全关闭后重启才能生效
• 确认变量配置层级：如果你将JAVA_HOME设为了用户变量，那么用管理员权限打开的cmd或者程序无法读取该变量，建议将JAVA_HOME改为系统变量，保证所有权限的进程都能读取
• 检查路径格式：你的JAVA_HOME路径包含空格（Program Files），不需要额外加双引号包裹，加引号反而会导致Gradle识别路径失败
• 核对执行命令格式：Windows系统cmd下不需要在命令前加.，直接执行gradlew build即可；如果使用Git Bash类的Linux风格终端，需要执行./gradlew build，且这类终端的环境变量和系统cmd不互通，需要单独配置。

3. java命令偶发找不到的修复 #

这个现象是Windows PATH路径优先级匹配导致，按以下步骤处理：

• 打开系统变量的PATH配置，将%JAVA_HOME%\bin项移到所有其他Java相关路径的最前面，保证系统优先读取你配置的JAVA_HOME下的命令
• 在报错的cmd窗口执行where java，查看输出的第一个路径是否为%JAVA_HOME%\bin\java.exe，如果不是，说明PATH里有优先级更高的Java路径（通常是Oracle安装时自动添加的C:\Program Files (x86)\Common Files\Oracle\Java\javapath），调整PATH顺序即可解决
• 验证修复效果：重启cmd后依次执行java -version和javac -version，如果两者都能正常输出版本信息，说明配置已生效，再执行Gradle构建即可正常运行。

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