核心是让maven编译行为脱离本地jdk干扰，强制使用项目声明版本；需在父pom中统一配置maven-compiler-plugin的source/target/release/encoding，并通过toolchains、idea四层设置及字节码验证确保三端一致。
核心是让 Maven 编译行为脱离本地 JDK 环境干扰，强制使用项目声明的版本。光改 pom.xml 不够，必须打通 Maven、IDE 和运行时三端配置。
在父 POM 中锁定编译器插件与 JDK 版本
多模块项目必须在根 pom.xml 的 <build><pluginmanagement></pluginmanagement></build> 中统一配置，避免子模块各自为政：
- 指定
maven-compiler-plugin版本（推荐 3.11.0 或更高） -
<source></source>和<target></target>必须一致，如都设为17（不是1.17） - 补充
<release></release>（JDK 9+ 推荐），它比source/target更严格，能阻止调用高版本私有 API - 显式设置
<encoding>UTF-8</encoding>，避免源码解析乱码间接影响编译
验证并约束 Maven 实际使用的 JDK
Maven 启动时默认用 JAVA_HOME 对应的 JDK，这会覆盖 pom.xml 配置。需双重保障：
- 执行
mvn -version查看 Maven 运行在哪个 JDK 上；若非目标版本，需修正系统级JAVA_HOME - 在
~/.m2/settings.xml中通过<profiles></profiles>+<toolchains></toolchains>声明所需 JDK 路径，再激活 profile，让 Maven 主动匹配而非依赖环境变量 - CI/CD 流水线中，直接指定构建镜像（如
maven:3.9-openjdk-17），从源头固化环境
同步 IntelliJ IDEA 的四层 JDK 设置
IDEA 有四个独立控制点，任一不一致都会导致“警告消失但编译仍错”：
-
Project SDK：File → Project Structure → Project，选与
pom.xml一致的 JDK（如 17） - Project language level：同上页面，必须与 SDK 版本匹配（如 SDK 是 17，language level 也选 17）
- Module SDK：Project Structure → Modules → 每个模块的 Dependencies 标签页，确认 SDK 正确
- Java Compiler bytecode version：Settings → Build → Compiler → Java Compiler，每个模块下拉菜单选对应版本（如 17）
快速诊断 class 文件是否真按预期生成
编译后不要只信日志，直接检查字节码版本：
- 执行
mvn clean compile - 找到输出目录下的某个
.class文件（如target/classes/com/example/App.class） - 运行
javap -verbose App.class | grep "major" - 结果应为对应版本号（如 JDK 17 →
major version: 61），否则说明某处配置未生效
不复杂但容易忽略，关键在统一和验证。
