强制统一JDK版本需三步：1. IDEA中Project和各Module的SDK与Language Level须手动一致；2. pom.xml中用maven-compiler-plugin显式设source/target；3. 通过maven-enforcer-plugin校验JAVA_HOME及构建环境。
IDEA 中多模块 Maven 项目如何强制统一 JDK 版本
IntelliJ IDEA 默认会为每个模块单独保存 project.sdk 和 language.level，即使父 POM 设了 maven-compiler-plugin，模块仍可能沿用旧 SDK。关键不是“能不能设”，而是“设在哪一层才真正生效”。
- 先检查
File → Project Structure → Project：这里设的Project SDK和Project language level控制新建模块的默认值，但**不会自动同步已有模块** - 必须手动进入每个模块的
Modules页签，确认其Language level和Module SDK与 Project 级一致；否则编译时可能报java: -source 17 requires -target 17类错误 - 在
pom.xml中显式锁定编译参数比依赖 IDE 更可靠：org.apache.maven.plugins maven-compiler-plugin 3.11.0 17 17 UTF-8
Maven 命令行构建时 JDK 版本不一致的排查路径
IDEA 里看着正常，但 mvn clean compile 报错 Unsupported class file major version 64？说明 Maven 运行时用的 JDK 和你期望的不一致——它只认 JAVA_HOME，完全不看 IDEA 设置。
- 执行
echo $JAVA_HOME（Linux/macOS）或echo %JAVA_HOME%（Windows），确认指向 JDK 17+ 路径 - 运行
mvn -v，检查输出中的Java version是否与预期一致；若不是，说明mvn启动脚本被环境变量或 wrapper 覆盖 - 如果项目用了
.mvn/wrapper/maven-wrapper.properties，检查其中distributionUrl是否隐式绑定了特定 JDK（某些企业镜像打包版会自带 JRE） - CI 环境中（如 GitHub Actions），必须显式用
actions/setup-java@v4指定java-version，不能依赖系统默认
Gradle 多子项目下 java.toolchain 的作用域陷阱
Gradle 17+ 推荐用 java.toolchain 替代旧的 sourceCompatibility，但它有层级优先级：根项目的 java { toolchain { ... } } **不会自动继承给子项目**，除非显式配置。
ViaooChain 维奥连锁招商网站系统
下载
网站功能资讯模块资料模块会员模块产品展示模块产品订购模块购物车模块留言模块在线加盟模块多级后台管理系统网站环境本系统为 asp.net开发donet版本为1.1框架数据库为acdess2000授权方式为免费，本版本本地可直接运行（使用http://localhost或http://127.0.0.1访问）如需放到外网通过域名访问，则需通过qq联系我免费索取钥匙文件，将钥匙文件放到网站空间根目录即可
- 在根
build.gradle中写：subprojects { java { toolchain { languageVersion = JavaLanguageVersion.of(17) } } } - 若子项目单独 apply 了
java插件但没声明 toolchain，则 fallback 到当前 Gradle 进程所用 JDK（可能为 11 或 21） - 验证是否生效：运行
./gradlew compileJava --debug | grep "toolchain"，看到类似Using toolchain 'JDK 17'才算落定 - 注意
java.toolchain只控制编译，test任务需额外配test { javaLauncher = javaToolchains.launcherFor {...} }
跨团队协作时 JDK 版本漂移的防御手段
最麻烦的不是自己设错，而是同事拉代码后 IDE 自动降级到本地已安装的最低 JDK（比如他只有 JDK 8 和 11），结果编译通过、运行时报 java.lang.UnsupportedClassVersionError。
立即学习“Java免费学习笔记（深入）”；
- 在项目根目录放
.java-version（供 SDKMAN! / jEnv 识别）和.sdkmanrc（含java=17.0.2-open），并写入 README 提示 - 用
maven-enforcer-plugin在构建时硬校验：org.apache.maven.plugins maven-enforcer-plugin enforce-java enforce [17,18) - VS Code 用户装了
Extension Pack for Java后，务必检查工作区设置里的"java.configuration.runtimes"是否包含对应版本，否则智能提示会乱
