IDE显示JDK 17但mvn compile报错，根源在于Maven实际调用的javac与IDE配置不一致；需统一PATH、JAVA_HOME、pom.xml或build.gradle及IDE模块语言级别设置。
IDE里显示JDK 17，但mvn compile报“source 17 is not supported”
这说明IDE用的是JDK 17，但Maven实际调用的javac不是它——mvn从PATH里找javac，而PATH可能还挂着旧JDK的bin目录。执行which javac（macOS/Linux）或where javac（Windows），看输出路径是否和$JAVA_HOME/bin/javac一致。不一致就删掉PATH中其他JDK的bin条目，只留一个。
IntelliJ里Project SDK设成JDK 17，但编译日志里出现“target 5”
这是IDE内部编译器把模块语言级别锁死了，和Project SDK无关。打开File → Project Structure → Modules，选中对应模块，在Language level下拉菜单里手动改成17（不是“Project default”）。再检查Build → Compiler → Java Compiler里的Target bytecode version，也必须是17。这两个值哪怕差一个数字，都会触发JDK 17拒绝生成低版本字节码的保护机制。
VS Code里java.home指向JDK 17，但终端里mvn clean compile仍用JDK 8
Maven完全不读VS Code配置，它只认系统环境变量和pom.xml。先确认echo $JAVA_HOME和mvn -v输出的Java版本是否一致；如果不一致，说明Maven启动脚本绕过了JAVA_HOME，改用自身MAVEN_OPTS或JRE_HOME。直接在项目根目录运行：mvn compile -Dmaven.compiler.source=17 -Dmaven.compiler.target=17验证是否临时生效。若生效，就在pom.xml里补全maven-compiler-plugin配置，否则每次都要加参数。
Gradle项目build.gradle写了sourceCompatibility = JavaVersion.VERSION_17，但IDEA仍提示“incompatible JDK”
Gradle配置只影响Gradle构建流程，IDEA默认不自动同步这些设置。必须手动触发一次Reload project：右键项目 → Reload project（或点击右上角Gradle面板的刷新按钮）。如果没反应，检查IDEA是否启用了Build, Execution, Deployment → Build Tools → Gradle → Use Gradle from设为Wrapper而非Local installation——用wrapper才能准确读取项目级Gradle配置。
最容易被忽略的是：IDEA的Module Language Level默认继承Project，但一旦你手动点过某个模块的设置，它就会脱离继承、变成独立值，后续Project SDK升级不会自动同步过去。这种“静默脱钩”在多模块项目里极难察觉。
