IntelliJ IDEA 报错 java:无效的源发行版 21 解决方案

IntelliJ IDEA 报错 java:无效的源发行版 21 解决方案

在 IntelliJ IDEA 开发 Java 项目时，如果遇到 java: invalid source release: 21 错误，通常意味着项目配置的 Java 语言级别与当前环境安装的 JDK 版本不匹配。这往往发生在升级了 JDK 但未同步更新 IDE 配置，或者构建工具（Maven/Gradle）未指定正确版本时。

下面按排查顺序给出解决步骤，建议依次检查。

1. 确认本地已安装 JDK 21

首先确保你的操作系统上确实安装了 Java 21。打开终端或命令提示符，输入以下命令：

java -version

如果输出显示类似 openjdk version "21..."，说明环境正常。若未安装或版本过低，请前往 Oracle 官网或 Adoptium 下载并安装 JDK 21。

注意： 安装后需设置环境变量 JAVA_HOME 指向 JDK 21 的安装路径，并确保 PATH 变量中包含 %JAVA_HOME%\bin。

2. 调整 IntelliJ IDEA 项目设置

IDEA 内部的项目级和模块级配置必须与 JDK 版本一致。

设置项目 SDK 与语言级别

1. 点击菜单栏 File > Project Structure（macOS 为 Project Settings）。
2. 在左侧选择 Project，右侧将 Project SDK 选为已安装的 Java 21。
3. 将 Project language level 设置为 21 - Modules, records, patterns, etc.。
4. 切换到 Modules 标签页，选中你的模块（如 main），在 Sources 选项卡下确认 Language level 同样设为 21。

检查编译器配置

1. 进入 File > Settings（macOS 为 Preferences）。
2. 导航至 Build, Execution, Deployment > Compiler > Java Compiler。
3. 确保 Project bytecode version 和各个模块的 Target bytecode version 均设置为 21。
4. 点击 OK 保存。

3. 验证构建工具配置

如果你的项目使用 Maven 或 Gradle 管理依赖，配置文件中的版本设置优先级可能高于 IDE 设置，需同步修改。

Maven 项目

在 pom.xml 的 <properties> 部分添加或修改如下内容：

<properties>
    <maven.compiler.source>21</maven.compiler.source>
    <>21