Gradle启动报“Could not determine java version”或“No Java runtime present”说明JAVA_HOME未正确指向含bin/java的JDK根目录，而非单纯版本不匹配；需验证$JAVA_HOME/bin/java -version可执行，且gradle-wrapper.properties中Gradle版本须兼容该JDK（如Java 21需Gradle 8.4+）。
Gradle 启动时提示 Could not determine java version 或 No Java runtime present
这说明 Gradle 根本没找到可用的 JDK，不是版本不匹配，而是路径失效或环境变量错配。最常见于 macOS/Linux 的 shell 配置未生效、Windows 的 JAVA_HOME 指向 JRE 或子目录错误。
-
JAVA_HOME必须指向含bin/java和bin/javac的 JDK 安装根目录（例如/Library/Java/JavaVirtualMachines/jdk-17.0.12.jdk/Contents/Home），不能是 JRE，也不能是jdk-17.0.12.jdk这种中间层目录 - 运行
echo $JAVA_HOME和$JAVA_HOME/bin/java -version两步都得成功；若后者报 command not found，说明JAVA_HOME路径不对 - Gradle 不读取
PATH中的java，只认JAVA_HOME；即使终端里java -version正常，Gradle 仍可能失败 - Android Studio 内置 JDK（如
/Applications/Android Studio.app/Contents/jbr/Contents/Home）可直接用，但需确保JAVA_HOME显式设为此路径，而非依赖 AS 自动注入
./gradlew 报错但 gradle -v 正常？wrapper 优先级搞错了
这是典型误解：你以为改了系统 gradle 命令就管用，其实项目里 ./gradlew 完全不看你装的全局 Gradle，它只看 gradle/wrapper/gradle-wrapper.properties 里的 distributionUrl，并用自己的逻辑启动 JVM —— 此时它会尝试读取 JAVA_HOME，若为空或无效，就崩。
- 检查
gradle/wrapper/gradle-wrapper.properties，确认distributionUrl指向的 Gradle 版本支持你手头的 JDK（比如 Gradle 8.4+ 才支持 Java 21） - 在项目根目录下直接运行
$JAVA_HOME/bin/java -version，确保该 JDK 可执行；再试./gradlew --version - 不要删掉
gradlew改用全局gradle，CI/CD 和协作会立刻出问题；wrapper 是事实标准
Gradle 报 Could not determine java version from '21.0.8'
这不是找不到 Java，而是 Gradle 版本太老，不认识新 JDK 的版本字符串格式。比如 Gradle 6.8 解析不了 21.0.8，它只认到 15，于是直接放弃识别，抛出这个模糊错误。
- 查官方兼容表：Gradle 7.x 支持 Java 8–17，Gradle 8.4+ 才支持 Java 21
- 别降级 JDK——Java 21 是 LTS，降级反而埋坑；直接升级 wrapper：
./gradlew wrapper --gradle-version 8.10 - 升级后检查
gradle/wrapper/gradle-wrapper.properties是否真的更新了distributionUrl，手动核对 URL 末尾版本号 - 注意：
gradle -v显示的 Java 版本是 Gradle 进程自身运行的 JDK，和你项目编译用的sourceCompatibility是两回事
IDEA 里跑 Gradle 任务失败，但终端里 ./gradlew 正常
IDEA 默认用自己的 JDK 启动 Gradle daemon，而不是复用你的 JAVA_HOME。它可能选了内嵌 JBR（JetBrains Runtime），而该 JBR 版本与项目 wrapper 不兼容。
- 进
Settings > Build > Build Tools > Gradle，把Gradle JVM改成Project SDK或显式指定你已验证过的 JDK 路径 - 勾选
Delegate IDE build/run actions to Gradle，让 IDEA 完全交由./gradlew处理，避免双 JVM 环境错乱 - 如果刚换过 JDK，务必点
File > Invalidate Caches and Restart > Invalidate and Restart，否则 IDEA 可能缓存旧的 daemon 连接
真正卡住人的地方，往往不是 Gradle 版本或 JDK 版本本身，而是「谁在哪个环节用了哪个 Java」——JAVA_HOME、wrapper 下载的 Gradle 自带的 JVM、IDEA 的 Gradle JVM、项目 build.gradle 里的 javaToolchain，四者可以完全不同。先厘清每一步的实际执行者，再动手改。
Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
