Gradle Java项目编译JDK由三层配置共同决定：gradle.properties中org.gradle.java.home指定守护进程JVM、build.gradle中java { version }声明源码/字节码版本、IDE中Gradle JVM与Project SDK需严格匹配；缺一可能导致IDE与命令行行为不一致。
Gradle Java项目编译用的JDK不是靠“装了哪个JDK就自动用哪个”，而是由三层独立配置共同决定：Gradle守护进程用的JVM、项目源码/字节码版本声明、以及构建工具链实际调用的javac路径。漏掉任何一层，都可能在IDE里能编译、命令行报错，或反过来。
gradle.properties里必须设org.gradle.java.home
这是最常被忽略的起点。Gradle默认不读JAVA_HOME，也不会自动选你IDE里配的JDK——它只认这个配置项。
- 在项目根目录的
gradle.properties中添加一行：org.gradle.java.home=/path/to/jdk-17（macOS/Linux）或org.gradle.java.home=C:\Program Files\Java\jdk-17.0.2（Windows） - 路径必须指向JDK根目录（含
bin/java和lib/tools.jar），不能是JRE - 如果没写这行，Gradle会 fallback 到系统
JAVA_HOME；若JAVA_HOME也没设，就用启动gradlew时当前shell的java命令——极易漂移 - 验证是否生效：
./gradlew --version | grep "Daemon JVM"，输出里的路径必须和你配置的一致
build.gradle里要声明java { version = ... }（Gradle 7.0+）
这一层控制的是javac行为本身：用什么语法、生成什么class文件版本。它和上一步的JDK路径是解耦的——你可以用JDK 21运行Gradle，但强制让javac按Java 17规则编译。
- 推荐写法（Gradle 7.0+）：
java { version = JavaVersion.VERSION_17 } - 旧版Gradle（sourceCompatibility = '17' 和
targetCompatibility = '17' - 别只改
sourceCompatibility：如果targetCompatibility没同步，可能出现“IDE提示正常，但运行时报Unsupported class file major version” - Spring Boot 3.x项目必须设为17或更高，否则启动直接失败
IDEA/Android Studio里别信“自动检测”
IDE的Project SDK、Gradle JVM、Language Level三者必须手动对齐，且不能依赖“Reload project”自动推断。
立即学习“Java免费学习笔记（深入）”；
- 打开
File > Project Structure > Project：Project SDK 和 Project language level 都要设成和java { version }一致（如17） - 再进
Settings > Build > Build Tools > Gradle：Gradle JVM 必须选和org.gradle.java.home相同的JDK路径 - 常见坑：
gradle.properties写了JDK 21，IDE里Gradle JVM却还勾着“Use embedded JDK (JetBrains Runtime)”，结果构建用的是JBR 17——编译通过，但record或sealed语法在运行时炸 - 每次切换分支后，先检查这三项，再点
Reload project，不要跳过
多模块项目里java { version }必须统一在根build.gradle
子模块如果各自写java { version }，容易出现父模块编译成Java 17、子模块还是Java 8，导致ClassNotFoundException或方法签名不匹配。
- 在根
build.gradle（或build.gradle.kts）里统一配置：subprojects { java { version = JavaVersion.VERSION_17 } } - 子模块的
build.gradle里删掉重复的java { ... }块 - 如果某个子模块真要降级（比如兼容老SDK），得显式覆盖：
java { version = JavaVersion.VERSION_11 }，但必须有明确理由并加注释 - Gradle Toolchain（
javaToolchain { languageVersion = JavaLanguageVersion.of(17) }）比老式sourceCompatibility更可靠，尤其在CI环境，建议优先用
真正麻烦的从来不是“怎么设”，而是设完之后没人验证——比如CI脚本里没传-Dorg.gradle.java.home，或者团队成员删掉了gradle.properties里的那行配置。每次构建前跑一次./gradlew compileJava --debug | grep "Compiling with"，比什么都实在。
