Gradle 报 JAVA_HOME 无效是因路径指向非标准 JDK（如 JRE、断链、架构不匹配），需用 /usr/libexec/java_home 获取真实路径并配置到 ~/.zshrc，同时确保 bin 下含 javac 等工具且架构一致。
Gradle 报 JAVA_HOME is set to an invalid directory，不是 JAVA_HOME 没设，而是它指向了一个 Gradle 不认的路径——常见于 macOS（尤其是 M1/M2）、多 JDK 共存、或 PATH 与 JAVA_HOME 错配的场景。
检查 JAVA_HOME 是否真实可执行
Gradle 启动脚本会严格检查 $JAVA_HOME/bin/java 是否存在且可执行，不看 java -version 是否能跑。很多用户 java -version 正常，但 $JAVA_HOME 指向的是 JRE、软链断裂目录、或 Rosetta 兼容版 JDK（而终端是原生 ARM），就会触发该错。
- 运行
echo $JAVA_HOME看当前值 - 执行
ls -la "$JAVA_HOME"，确认目录存在且非空 - 执行
ls -la "$JAVA_HOME/bin/java"，必须是可执行文件（不是 broken symlink） - 在 zsh 中用
greadlink -f "$JAVA_HOME/bin/java"（需先brew install coreutils）看是否最终指向真实 JDK Home；若返回空或报错，说明链路断了
用 /usr/libexec/java_home 获取权威路径
macOS 的 /usr/libexec/java_home 是系统唯一可信的 JDK 注册中心，它不依赖环境变量，只读取 /Library/Java/JavaVirtualMachines/ 下已安装的 JDK 清单。
- 运行
/usr/libexec/java_home -V查看所有注册 JDK，例如：17.0.1 (arm64) /Library/Java/JavaVirtualMachines/jdk-17.0.1.jdk/Contents/Home - 选中你要用的版本（注意括号里的架构，ARM 项目别选 x86_64），复制其路径
- 在
~/.zshrc中写死：export JAVA_HOME=/Library/Java/JavaVirtualMachines/jdk-17.0.1.jdk/Contents/Home - 执行
source ~/.zshrc，再试gradle -v
Gradle 自身 wrapper 或脚本可能覆盖 JAVA_HOME
某些 Gradle 安装包（尤其旧版或第三方打包版）会在 gradle 启动脚本里硬编码 JAVA_HOME，导致你 shell 里设的被忽略。这不是 bug，是设计行为。
- 运行
which gradle找到脚本位置，比如/opt/gradle/bin/gradle - 用
less /opt/gradle/bin/gradle查看开头几十行，搜索JAVA_HOME=或if [ -z "$JAVA_HOME" ] - 如果发现硬编码路径（如
JAVA_HOME=/usr/lib/jvm/java-8-openjdk），直接编辑该脚本，替换成你的真实 JDK 路径 - 更稳妥的做法是：不用全局
gradle命令，改用项目级./gradlew，它通过gradle/wrapper/gradle-wrapper.properties和org.gradle.java.home控制 JDK，不受系统 JAVA_HOME 干扰
Android Studio 用户特别注意 Gradle JDK 与 JAVA_HOME 冲突
Android Studio 默认用自带 JBR（JetBrains Runtime），而你系统 JAVA_HOME 指向另一个 JDK，Gradle daemon 就会警告 “different JDK locations”，严重时导致多 daemon 启动、内存飙高、构建变慢。
- 在 Android Studio 中打开
File → Project Structure → SDK Location，查看Gradle Settings → Gradle JDK - 把它改成和
$JAVA_HOME一致的路径（比如/Library/Java/JavaVirtualMachines/jdk-17.0.1.jdk/Contents/Home） - 或者反向操作：把
JAVA_HOME改成 Android Studio 的 JBR 路径（/Applications/Android Studio.app/Contents/jbr），但要注意 JBR 通常不含javac，会影响部分插件编译 - 改完后务必执行
./gradlew --stop杀掉旧 daemon，否则新配置不生效
最易被忽略的一点：Gradle 对 JDK 的要求不仅是“能运行”，还要求路径下有 javac、jar 等工具，且架构（arm64/x86_64）与当前 shell 进程匹配。哪怕 java -version 显示正常，只要 $JAVA_HOME/bin 里缺关键命令或架构错位，Gradle 就会拒绝启动。
Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
