Spring Boot 3.0.1 构建失败：Java 版本不兼容问题详解

心靈之曲 2026-01-18 00:00:00 次阅读

spring boot 3.x 要求最低 java 17 运行环境，而当前使用 java 11 导致 `spring-boot-maven-plugin:3.0.1` 的 `build-info` 目标加载失败（class file version 61.0 → 对应 java 17），需升级 jdk 并同步配置 maven 工具链。

Spring Boot 自 3.0 版本起正式放弃对 Java 11 的支持，最低要求 JDK 17（LTS），且推荐使用 JDK 17 或 JDK 21（当前最新 LTS）。你遇到的错误：

Unable to load the mojo 'build-info' [...] 
has been compiled by a more recent version of the Java Runtime (class file version 61.0), 
this version of the Java Runtime only recognizes class file versions up to 55.0

明确揭示了版本不匹配问题：

class file version 61.0 → 编译目标为 Java 17（Java 版本与 class 文件版本对应关系：Java 11 → 55，Java 17 → 61）；
当前 java -version 显示为 OpenJDK 11（55.0），无法加载 Java 17 编译的插件类。

✅ 正确解决方案如下：

1. 升级 JDK 至 17（推荐）或更高版本

以 Ubuntu/WSL2 环境为例，安装 OpenJDK 17：

# 添加官方仓库并安装
sudo apt update
sudo apt install openjdk-17-jdk

# 验证安装
java -version
# 输出应类似：openjdk version "17.0.9" 2025-10-17

2. 配置系统默认 Java 版本（可选但推荐）

sudo update-alternatives --config java
# 选择 JDK 17 对应路径（如 /usr/lib/jvm/java-17-openjdk-amd64/bin/java）

3. 确保 Maven 使用正确 JDK

Maven 会继承系统 JAVA_HOME。设置并验证：

export JAVA_HOME=/usr/lib/jvm/java-17-openjdk-amd64
mvn -v

输出中 Java version 应显示 17.x.x，而非 11.x.x。

4. 清理并重新构建项目

cd spring-petclinic
./mvnw clean package -DskipTests

? 提示：Spring PetClinic 主分支已全面适配 Spring Boot 3.x，其 pom.xml 中声明 17，因此必须匹配 JDK 17+ 环境。若仍使用旧版分支（如 2.7.x），可降级 Spring Boot 版本，但不建议——新功能、安全更新和长期维护均聚焦于 3.x + JDK 17+ 组合。

⚠️ 注意事项

Maven 3.6.0 可用，但建议升级至 3.8.1+ 以获得更好的 JDK 17 兼容性；
不要仅靠 mvn compile 测试——spring-boot-maven-plugin:3.0.1:build-info 是 package 阶段默认绑定的目标，必须执行完整生命周期；
若使用 IDE（如 IntelliJ IDEA），还需在 Project Settings → Project SDK 和 Settings → Build → Maven → Importing → JDK for importer 中统一设为 JDK 17。

完成上述配置后，构建将成功通过，日志中可见 [INFO] BUILD SUCCESS。Spr