在
IntelliJ IDEA 启动项目时报错 `
java: 无效的
源发行版: 21`，通常表明项目的
Java 版本配置与当前项目设置不兼容。以下是完整的解决方案：
### 1. 检查项目中的
Java 版本配置
在 `pom.xml`（Maven 项目）或 `build.gradle`（Gradle 项目）中，可能存在指定的
Java 版本与实际使用的 JDK 不一致。例如，若 `pom.xml` 中设置了如下内容：
```xml
<properties>
<
java.version>21</
java.version>
</properties>
```
但当前系统中没有安装 JDK 21 或者
IntelliJ IDEA 没有正确配置 JDK 21，将导致此错误。请根据实际使用的 JDK 版本修改为对应的版本号，如 `1.8`、`
11` 或 `17` 等[^1]。
### 2. 配置 Project SDK 与 Language Level
进入 **File → Project Structure → Project**，确保以下设置：
- **Project SDK**：选择本地安装的 JDK 版本（如 1.8、
11、17）。
- **Project language level**：设置为与 SDK 对应的语言等级（例如，JDK 8 对应的语言等级为 8
- Lambdas, type annotations etc.）[^4]。
### 3. 配置模块的源码兼容性
进入 **File → Project Structure → Modules → Sources**，检查每个模块的 **Language level**，确保其与项目的 **Project language level** 一致，避免因模块语言等级不一致导致编译错误[^4]。
### 4. 配置模块的依赖项 SDK
进入 **File → Project Structure → Modules → Dependencies**，确保模块依赖的 SDK 与全局设置一致，即使用与项目匹配的 JDK 版本。如果 SDK 列表中没有合适的版本，可点击 "+" 号手动添加本地 JDK 安装路径[^3]。
### 5. 设置
Java 编译器版本
进入 **File → Settings → Build, Execution, Deployment → Compiler →
Java Compiler**，在 **Per
-module bytecode version** 中确保每个模块的字节码版本与使用的 JDK 版本匹配。例如，JDK
11 应设置为
11，JDK 17 应设置为 17 等[^4]。
### 6. 检查 Lombok 插件与注解处理器（适用于使用 Lombok 的项目）
如果项目中使用了 [Lombok](https
://projectlombok.org/)，需要确保以下配置：
- 在 **Settings → Plugins** 中安装并启用 Lombok 插件。
- 在 **Settings → Build, Execution, Deployment → Compiler → Annotation Processors** 中勾选 **Enable Annotation Processors**。
- 在 `build.gradle` 文件的 `dependencies` 块中添加 Lombok 的依赖与注解处理器：
```gradle
dependencies {
compileOnly 'org.projectlombok
:lombok
:1.18.24'
annotationProcessor 'org.projectlombok
:lombok
:1.18.24'
}
```
或在 `pom.xml` 中添加：
```xml
<dependency>
<groupId>org.projectlombok</groupId>
<artifactId>lombok</artifactId>
<version>1.18.24</version>
<scope>prov
ided</scope>
</dependency>
```[^2]
### 7. 重启
IntelliJ IDEA
完成上述配置后，重启
IntelliJ IDEA 以确保所有更改生效。重新构建项目（Build → Rebuild Project）并尝试运行。
---
本文介绍了解决IDEA中项目Java版本不匹配的问题。当pom.xml指定的java.version为1.8，且本机已安装对应版本的JDK时，可通过调整IDEA设置使项目正确识别Java版本。具体步骤包括：点击File菜单，选择Project Structure，然后修改项目设置。
扫一扫
4900
被折叠的 条评论
为什么被折叠?
到【灌水乐园】发言
