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 为例）：
<parent>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-parent</artifactId>
<version>3.2.12</version>
<relativePath/>
</parent>
关键点：
立即学习“Java免费学习笔记（深入）”；
-
<relativePath/>表示从中央仓库拉取 parent POM，不要留空或写错路径 - 别手动复制一堆
<dependency>替代 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 的 <build><plugins> 中添加：
<plugin>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-maven-plugin</artifactId>
</plugin>
注意：
- 不用写
<version>—— parent 已经管理了匹配版本 - 如果用了
<scope>test</scope>或放在<pluginManagement>里没实际启用，插件不会生效 - 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 自作主张）：
<properties>
<java.version>17</java.version>
</properties>
错误现象包括：
-
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”或“端口没被占用却启动卡住”。
