IDEA报JDK版本错误主因是四层JDK配置脱节：启动JVM、项目SDK、模块Language level、构建工具target不一致，需逐层检查并同步更新，否则仅改一处无效。
终端能编译说明 javac 本身没问题，IDE 报版本错误，基本是 IDEA 没用你终端那个 JDK——它在用自己的 SDK、自己的编译器设置、甚至自己的启动 JVM。
确认终端和 IDEA 实际用的 JDK 是不是同一个
很多人只比对 java -version 和 javac -version，却漏了 IDEA 自己运行时依赖的 JDK。IDEA 是个 Java 应用，它得先跑起来，才能编译你的代码。如果它自己用的是 JDK 8 启动，那即使你项目配了 JDK 17，它内部解析器也大概率不认 record、sealed 或虚拟线程语法，直接标红或报 Cannot resolve symbol。
- 查 IDEA 启动 JDK：打开
idea.vmoptions（macOS/Linux）或idea64.exe.vmoptions（Windows），路径在 IDEA 安装目录的bin/下，找-Djava.home=行；没这行就看$JAVA_HOME是否指向旧版 JDK - 查项目 SDK：按
Ctrl+Alt+Shift+S→Project→ 看Project SDK是否和终端一致（比如都是OpenJDK 17.0.11，不只是“17”） - 查模块 SDK：同一窗口 →
Modules→ 逐个点开模块 →Sources标签页 → 确认Language level和Target bytecode version没被单独设成 5、6、8 这类老版本
为什么改了 Project SDK 还报 “JVM target 5”
因为 IDEA 的模块（module）配置优先级高于项目（project）配置。报错里明确写了 module 'api-test-fix1'，说明这个模块在 Project Structure → Modules 里被手动设成了 Language level 5，而 JDK 17 的 javac 已经彻底不支持 -source 5 ——它连解析都拒绝，根本不会走到编译那步。
- 不要只改 Project 的 Language level，必须进每个 module 单独检查并同步修改
- 如果模块是从 Maven 导入的，IDEA 可能会把
pom.xml里的<java.version>17</java.version>当作依据；但若该模块没配或配错，IDEA 就 fallback 到默认值（常是 5 或 6） - 改完 Language level 后，别只点 OK，要点击右下角的
Reload project（Maven）或Load Gradle project（Gradle），否则变更不生效
Maven/Gradle 配置和 IDEA 编译器目标不一致
IDEA 默认用内置编译器（而非 Maven 的 javac），所以即使 pom.xml 里写了 <maven.compiler.source>17</maven.compiler.source>，IDEA 仍可能按自己设定的 target 版本去校验语法，导致“终端 mvn compile 成功，IDEA 里满屏红色”。
- 在
Settings → Build, Execution, Deployment → Compiler → Java Compiler中，确认Project bytecode version和Per-module bytecode version都设为 17（或与 SDK 匹配） - 勾选
Use compiler from module's SDK（如果可用），强制 IDEA 跟模块绑定的 JDK 保持一致 - 对 Maven 项目，建议关闭
Build project automatically，改用mvn compile命令行验证；避免 IDEA 编译器和 Maven 编译器行为差异引发误判
缓存和残留配置让问题反复出现
IDEA 的缓存机制很顽固。你改了 SDK，它可能还在用上一次解析出的符号表；你删了旧 JDK，它配置里还留着路径引用；甚至 .idea/misc.xml 里硬编码了 project-jdk-name="1.8" 这种字段。
- 执行
File → Invalidate Caches and Restart → Just Restart是最轻量的清理方式 - 更彻底的做法：关掉 IDEA，删掉项目根目录下的
.idea/文件夹 +*.iml文件，再重新 Import Project（Maven/Gradle） - 检查
.idea/misc.xml是否含<component name="ProjectRootManager">里写死的旧 jdk-name；有就手动删掉或替换
真正麻烦的从来不是“找不到配置在哪”，而是四层 JDK（IDEA 启动 JVM、项目 SDK、模块 Language level、构建工具 target）中任意一层脱节，都会触发不同形态的报错。改一处就以为好了，往往只是把错误压到了下一层。
