模块SDK必须手动设置且不能继承Project SDK，否则即使Project SDK设为JDK 21，模块仍可能显示或旧版本，导致编译报错、类无法解析、运行时版本错误；需在Project Structure→Modules→Dependencies中明确选择已注册的JDK路径（如Contents/Home），同步匹配Language level，并确保Run Configuration的JRE设置一致。
模块 SDK 必须手动设，不继承 Project SDK
IDEA 默认不会把 Project SDK 自动同步给 Modules，哪怕你在 Project Settings 里选好了 JDK 17，所有 Module 的 Module SDK 仍可能显示 java.lang.String 报红、Maven 构建成功但 IDEA 运行失败。
操作路径：File → Project Structure → 左侧选 Modules → 点开目标模块 → 右侧切到 Dependencies 标签页 → 找到 Module SDK 下拉框。
- 若下拉列表为空，先去
Platform Settings → SDKs注册好对应 JDK（比如 OpenJDK 21） - 选中已注册的 OpenJDK 版本（不是
- 同步检查下方
Language level是否匹配（OpenJDK 21 对应选21） - 点
Apply，不是只点OK—— 否则配置不生效
OpenJDK 路径必须指向 Contents/Home（macOS）或根目录（Windows/Linux）
选错路径是“注册了却用不上”的主因。IDEA 要求的是 JDK 安装根目录，即包含 bin/、lib/、jmods/ 的那层，不是 bin/java，也不是 jre/ 子目录。
常见正确路径示例：
- macOS：
/Library/Java/JavaVirtualMachines/jdk-21.jdk/Contents/Home - Windows：
C:\Program Files\Java\jdk-21（避免空格时可用C:\Progra~1\Java\jdk-21） - Linux：
/usr/lib/jvm/java-21-openjdk-amd64（用update-java-alternatives -l确认）
如果路径里含中文或空格，IDEA 可能静默失败——哪怕 java -version 在终端能跑通。
多模块混用 OpenJDK 版本时，Maven/Gradle 配置不能替代 Module SDK
就算 pom.xml 里写了 build.gradle 设了 sourceCompatibility = JavaVersion.VERSION_21，IDEA 依然会按 Module SDK 去做语法校验、代码补全和调试启动。两者不一致就会出现：
- 编辑器提示 “Cannot resolve symbol”（但
mvn compile成功） - 运行时抛
UnsupportedClassVersionError - 断点无法命中，或调试器显示变量为
null
务必保证三者对齐：Module SDK + Language level + 构建工具配置。尤其注意测试模块（如 test）有时需要降级 JDK 11 来兼容旧框架，这时它必须单独配 SDK，不能共用主模块的 OpenJDK 21。
运行配置（Run Configuration）容易漏掉 JRE 设置
Module SDK 设对了，但右上角运行按钮仍用错 JDK？检查 Edit Configurations… 里的 JRE 字段：
- 默认是
Project default，但这个“default”实际取自当前运行配置所关联的模块的Module SDK - 如果运行配置绑定了错误模块（比如绑了
api模块却想跑service），JRE 就会错 - 可显式选
Use project JDK或直接指定某个已注册的 OpenJDK 路径
Tomcat / Spring Boot Run Configuration 还要额外确认 Environment variables 里没硬编码 JAVA_HOME 指向旧版本 —— 它会覆盖 IDEA 的 SDK 选择。
真正卡住人的，从来不是找不到 JDK 路径，而是以为设了 Project SDK 就万事大吉，结果 Module SDK 仍是灰色的
