Gradle 的 JVM Toolchain 支持按子项目独立指定 JDK 版本，如 core 模块用 Java 11、service 模块用 Java 21，但不支持单个模块内混合编译；需在各子模块 build.gradle 中分别配置 java { toolchain { languageVersion = ... } }，确保编译、测试及依赖解析均使用对应 JDK。
Gradle 的 JVM Toolchain 支持为不同子项目或任务指定独立 JDK 版本，但不支持单个子项目内“混合源码用多个 JDK 编译”（比如一个模块里部分类用 Java 11、部分用 Java 21）。所谓“基于不同 JDK 版本的混合项目”，实际指多模块项目中各模块目标 JDK 不同，例如：core 模块需兼容 Java 11，service 模块启用 Java 21 新特性。精准交叉编译的关键是按模块隔离 toolchain，而非在同一个编译单元里切换 JDK。
按子项目分别配置 toolchain
在各子模块的 build.gradle 或 build.gradle.kts 中单独声明，互不影响：
- Groovy DSL 示例（service 模块）：
java { toolchain { languageVersion = JavaLanguageVersion.of(21) } } - Kotlin DSL 示例（legacy 模块）：
java { jvmToolchain(11) } - 无需全局统一，也不依赖 root project 的配置；subprojects 块里统一设反而会覆盖差异需求
确保构建时真正使用对应 JDK，而非仅生成字节码
toolchain 不只控制 javac 版本，还影响测试运行、注解处理器、甚至依赖解析（如某些库的 classpath 探测）。验证是否生效：
- 运行
./gradlew compileJava --info，日志中会出现类似Using toolchain 'JDK 21 (Adoptium)' - 检查编译输出的 class 文件版本：
javap -verbose build/classes/java/main/SomeClass.class | grep "major version"（Java 21 → major version 65） - 若仍报错
Unsupported class file major version，说明 Gradle 自身运行时 JDK（即org.gradle.java.home）太低，需升级 Gradle 版本或显式指定其运行环境
避免跨模块依赖引发的隐式版本污染
当 A 模块（Java 21）依赖 B 模块（Java 11）时，B 的编译产物必须能被 A 的编译器接受。关键约束：
立即学习“Java免费学习笔记（深入）”；
- B 模块的
targetCompatibility = 11（或 toolchain 设为 11），确保生成 class 文件兼容 JRE 11+ - A 模块引用 B 时，不会强制提升 B 的字节码版本；但若 A 使用了 B 中 Java 21 特有的 API（如
SealedClass），编译仍会失败——这是语义层面限制，非 toolchain 能绕过 - 推荐做法：在
settings.gradle中明确声明各模块路径，并在各自build.gradle中独立配置 toolchain，不共享sourceCompatibility
CI/CD 和团队环境下的稳定落地
本地开发和流水线需行为一致，不能靠开发者手动切 JAVA_HOME：
- 在根目录
gradle.properties中设置org.gradle.java.home仅用于指定 Gradle 进程自身运行的 JDK（建议 ≥ Gradle 所需最低版本），不影响模块 toolchain - 让 Gradle 自动下载匹配 JDK：在
settings.gradle中启用 Foojay Resolver 插件，声明enableFeaturePreview('VERSION_CATALOGS')后，toolchain 可自动拉取 Adoptium 11/17/21 等官方构建 - IDE 导入时，IntelliJ 会读取各模块的
java.toolchain并自动配置 SDK；Eclipse 需安装 Buildship 3.4+ 并启用 “Use Gradle’s JVM toolchain” 选项
