project sdk未设置或指向无效路径是最常见原因，需在file→project structure→project中确认sdk已选择有效jdk目录（非jre子目录），并检查modules、java compiler及缓存是否一致。
Project SDK 未设置或指向无效路径
这是最常见原因：IDEA 显示 Invalid JDK configuration，但实际是 Project SDK 根本没选，或选了却指向一个不存在、权限受限或签名不被信任的 JDK 目录（比如 GraalVM 或某些定制 JDK 未通过 JetBrains 白名单校验）。
- 打开
File → Project Structure → Project，确认Project SDK下拉框不是空的，且显示的是类似jdk-17.0.2这样的有效名称，而不是<no sdk></no>或灰色不可选状态 - 如果下拉列表为空，点击右侧
+→JDK，手动定位到 JDK 安装目录（如/Library/Java/JavaVirtualMachines/jdk-17.jdk/Contents/Home或C:\Program Files\Java\jdk-17.0.2），**不要选 JRE 子目录，必须选Home或顶层jdk-xx文件夹** - 若路径正确却仍报 invalid，执行
./list-jdks.sh --verbose（Linux/macOS IDEA bin 目录下）或查看 IDEA 启动日志里是否出现SDK signature mismatch—— 此时需换用 Temurin、Liberica 或官方 OpenJDK 构建版本
Modules 的 SDK 与 Project 不一致
IDEA 优先读取模块级配置，哪怕 Project SDK 设置正确，只要某个 module 的 Module SDK 是空的或指向旧 JDK，整个模块就视为配置无效，触发全局报错。
- 在
Project Structure → Modules中，展开每个 module（尤其主模块和 test 模块），检查右侧Module SDK是否为Project SDK或明确指定为同一 JDK 版本 - 不要依赖“inherit project SDK”自动继承 —— 某些插件或导入逻辑会清空该继承关系，务必手动点选一次
- 如果模块列表里出现红色叹号或
Cannot find JDK home directory，说明该 module 绑定的 JDK 路径已失效，需重新选择或删除该 module 后重新导入
Java Compiler 设置覆盖了 SDK 版本
Settings → Build, Execution, Deployment → Compiler → Java Compiler 里的 Target bytecode version 如果设为 17，但 Project SDK 实际是 JDK 8，IDEA 就会拒绝编译并报 Invalid JDK configuration —— 它把字节码目标版本当作了 JDK 能力边界。
- 该设置必须 ≤ Project SDK 支持的最高版本（JDK 17 支持 target 17，但不支持 target 21；JDK 21 才支持 target 21）
- 建议保持此项为
Same as project bytecode version，避免手动设死；若必须手动指定，请确保数值与Project SDK版本一致 - Gradle/Maven 项目中，此设置仅作为 fallback，真正生效的是
build.gradle里的sourceCompatibility = JavaVersion.VERSION_17或pom.xml中的<maven.compiler.source>17</maven.compiler.source>
缓存残留导致 SDK 元数据损坏
IDEA 2024.1+ 对 JDK 签名和元数据做了强校验，升级后或切换分支时，旧缓存可能保留已失效的 SDK 描述符，造成“明明选了 JDK 17，却提示 invalid”的假象。
- 先尝试
File → Invalidate Caches and Restart → Invalidate and Restart，**不要勾选 “Just restart”** - 若仍无效，临时关闭项目，删掉项目根目录下的
.idea文件夹和所有*.iml文件，再重新Open → 项目根目录导入（Maven/Gradle 会自动重建模块配置） - 注意：
.idea删除后，本地运行配置、代码模板等会丢失，但 SDK 配置本身不会 —— 因为它实际存储在 IDE 全局配置中，重装 IDEA 也不会丢
list-jdks.sh 输出比反复点选界面更直接。
