Spring Boot无需安装,需正确配置Maven构建环境:必须声明spring-boot-starter-parent父POM,启用spring-boot-maven-plugin插件,确保Maven 3.8.6+、JDK 17+及各层级Java版本一致。

Spring Boot 不需要“安装”,它不是独立运行的软件,而是基于 Maven 或 Gradle 的 Java 库集合。你真正要做的,是配置一个能正确下载、解析并运行 Spring Boot 依赖的构建环境。
用 Maven 创建 Spring Boot 项目时,pom.xml 必须声明 spring-boot-starter-parent
这是最常见也最容易被跳过的一步。没有它,@SpringBootApplication 可能编译通过但启动失败,或版本冲突导致 ClassNotFoundException。
正确写法(以 Spring Boot 3.2.x 为例):
org.springframework.boot spring-boot-starter-parent 3.2.12
关键点:
立即学习“Java免费学习笔记(深入)”;
-
表示从中央仓库拉取 parent POM,不要留空或写错路径 - 别手动复制一堆
替代 parent —— 会丢失依赖管理、插件默认配置和 Java 版本约束 - 如果公司私有仓库没同步该 parent,Maven 会报
Could not find artifact org.springframework.boot:spring-boot-starter-parent:pom:3.2.12
IDE 启动失败?检查 spring-boot-maven-plugin 是否启用
IntelliJ 或 Eclipse 能直接运行 main 方法,但打包成 .jar 或用 mvn spring-boot:run 启动时,必须有这个插件,否则提示 Plugin 'org.springframework.boot:spring-boot-maven-plugin:' not found。
在 pom.xml 的 中添加:
org.springframework.boot spring-boot-maven-plugin
注意:
- 不用写
—— parent 已经管理了匹配版本 - 如果用了
或放在test 里没实际启用,插件不会生效 - Spring Boot 3+ 要求 Maven 3.8.6+,旧版 Maven 会静默忽略该插件
Java 版本不匹配:Spring Boot 3.x 强制要求 JDK 17+
即使 java -version 显示 17,IDE 或 Maven 仍可能用错 JDK —— 常见于 macOS 多 JDK 共存、Windows PATH 混乱、或 IntelliJ 的 Project SDK / Maven runner JDK 设置不一致。
验证方式:
- 命令行执行
mvn -v,看输出里的Java version - 在
pom.xml中显式声明编译级别(避免 IDE 自作主张):
17
错误现象包括:
-
Unsupported class file major version 61(JDK 17 对应 61)→ 实际用了 JDK 16 或更低 -
java.lang.NoClassDefFoundError: jakarta/servlet/Filter→ Spring Boot 3 使用 Jakarta EE 9+,旧 Servlet API 包名已变,JDK 版本不对常连带暴露此问题
真正的难点不在“怎么配”,而在于多个层级(系统 JDK、Maven 配置、IDE 项目 SDK、java.version 属性)之间容易脱节。哪怕只有一处没对齐,就可能表现为“明明写了注解却扫不到 Controller”或“端口没被占用却启动卡住”。










