### 错误原因分析
`
Unsupported class file major
version 61` 表示编译后的 `
.class` 文件是由 Java 17 编译器生成的，而
运行时使用的
JDK 版本低于 Java 17。因此，
运行环境中无法识别该版本的字节码文件[^2]。
在 IDEA 中使用
JDK 17
运行项目时出现 `
unsupported class file major
version 25617` 的错误可能是由于以下几个原因之一：
1
. **Gradle 或 Maven 配置中的
JDK 版本不一致**：
项目的构建工具可能指定了较低的
JDK 版本来编译代码。
2
. **IDEA 设置中的
JDK 不匹配**：虽然选择了
JDK 17，但其他设置可能导致实际
运行环境未正确应用
JDK 17。
3
. **Spring Boot
项目依赖冲突**：某些依赖项可能需要特定的
JDK 版本才能正常工作。
---
### 解决方案
#### 1
. 统一 Gradle/Maven 配置中的
JDK 版本
如果
项目使用的是 Gradle 构建工具，则需确保其配置与
JDK 17 对应。以下是调整方法：
- 修改 `build
.gradle` 文件中的 `sourceCompatibility` 和 `targetCompatibility` 属性：
```groovy
java {
sourceCompatibility = Java
Version.VERSION_17
targetCompatibility = Java
Version.VERSION_17
}
```
对于 Maven 用户，修改 `pom
.xml` 文件中的 `<properties>` 节点：
```xml
<properties>
<maven
.compiler
.source>17</maven
.compiler
.source>
<maven
.compiler
.target>17</maven
.compiler
.target>
</properties>
```
这一步可以确保源代码和目标字节码都基于
JDK 17 编译[^3]。
---
#### 2
. 检查并更新 IDEA 的
JDK 配置
在 IntelliJ IDEA 中执行以下操作以确保所有相关设置均指向
JDK 17：
- 打开 **
File -> Project Structure**，检查以下选项：
- **Project SDK**: 确保已选择
JDK 17。
- **Modules**: 查看模块的语言级别是否为 `SDK default (17)`。
- 如果尚未安装
JDK 17，请通过 **
File -> Project Structure -> SDKs** 添加新的
JDK 安装路径。
此外，在全局层面也需要验证 IDEA 使用的
JDK 是否正确：
- 前往 **Help -> Edit Custom VM Options**，确认 `-Didea
.jdk` 参数指向
JDK 17。
---
#### 3
. 清理缓存并重新构建
项目
即使完成了上述更改，仍可能存在旧的字节码残留。建议清理缓存并强制重新下载依赖项：
- 在终端中
运行以下命令清除本地缓存：
```bash
rm -rf
.gradle/caches/
mvn clean install
```
- 若使用 Gradle，则可尝试同步
项目后再重建：
```bash
./gradlew clean build --refresh-dependencies
```
---
#### 4
. 更新 Spring Boot 及相关依赖
根据引用信息[^4]，当前
项目使用了 Spring Boot 3
.2
.2 和 Maven 3
.5
.0。需要注意的是，Spring Boot 3
.x 默认支持 Java 17 及以上版本。然而，部分插件或库可能仍然存在兼容性问题。可以通过升级到最新稳定版来解决问题。
例如，将 `spring-boot-starter-parent` 升级至更高版本（如 3
.2
.3 或后续版本）：
```xml
<parent>
<groupId>org
.springframework
.boot</groupId>
<artifactId>spring-boot-starter-parent</artifactId>
<
version>3
.2
.3</
version>
</parent>
```
随后再次
运行构建流程。
---
### 总结
通过统一 Gradle/Maven 配置、校正 IDEA 的
JDK 设置以及清理缓存等方式，能够有效解决因
JDK 版本不匹配引发的 `
Unsupported class file major
version 61` 类型错误。同时注意保持框架及其依赖处于最新状态以减少潜在冲突。
---
本文介绍了当Eclipse中配置的JDK版本与项目需求不符时的解决方案。具体步骤包括调整Eclipse的编译器合规级别及确保已安装的JRE版本与项目要求一致。此外，还提及了在项目的Java Build Path设置中进行必要的调整。
扫一扫
1万+
被折叠的 条评论
为什么被折叠?
到【灌水乐园】发言
