直接用Spring Initializr创建最省事,关键在于对齐JDK、Maven、Spring Boot三版本:JDK 8配Spring Boot 2.7.x,JDK 17/21配3.2.x;推荐IDEA内置Initializr(URL换为https://start.aliyun.com)或官网生成后导入;项目启动后加HelloController类并访问http://localhost:8080/hello即可验证成功。

直接用 Spring Initializr 创建最省事,关键不是“快”,而是把 JDK、Maven、Spring Boot 版本这三者对齐——只要配对了,5 分钟内就能跑出 “Hello Spring Boot”。
一、环境准备:先确认三个版本能不能握手
别急着点 “新建项目”,先打开终端输入:
- java -version:看是 JDK 8(显示 1.8)、JDK 17 还是 JDK 21
- mvn -v:确认 Maven 已安装,版本建议 3.6+(3.9.9 更稳)
然后对照选 Spring Boot 版本:
- JDK 8 → 选 Spring Boot 2.7.x(长期维护版,兼容性好)
- JDK 17 或 21 → 直接选 Spring Boot 3.2.x(主流新版本,无 javax 包名迁移烦恼)
二、创建项目:推荐两种可靠方式
方式 1:IDEA 内置 Initializr(最顺滑)
- 打开 IDEA → New Project → 左侧选 Spring Initializr
- URL 改成国内镜像:https://start.aliyun.com(避免卡在下载依赖)
- 填 Group(如 com.example)、Artifact(项目名)、Java 版本、打包类型(Jar)
- 依赖只勾一个:Spring Web(够跑第一个接口)
方式 2:官网生成后导入(最可控)
- 访问 https://start.aliyun.com(比官方 start.spring.io 更快)
- 填好基本信息,加 Spring Web,点 “Generate” 下载 zip
- 解压 → IDEA 中选择 “Open” 导入该文件夹(不要选 “Import Project”)
三、跑通第一个接口:三步验证是否成功
项目导入后,按顺序做三件事:
- 找到 src/main/java 下的主启动类(名字类似 DemoApplication),右键 Run 启动
- 等控制台出现 Tomcat started on port(s): 8080,说明服务已就绪
- 新建一个类 HelloController.java,放在同级包下,内容如下:
@RestController
public class HelloController {
@RequestMapping("/hello")
public String hello() {
return "Hello Spring Boot!";
}
}
保存后刷新浏览器访问 http://localhost:8080/hello,看到文字就代表搭建完成。
四、几个容易卡住的细节提醒
- Maven 本地仓库路径最好手动指定(比如 D:/repository),避免默认在 C 盘导致权限或空间问题
- 如果 IDEA 右下角一直转圈下载依赖,检查 Settings → Build → Maven → 本地设置文件(setting.xml)是否指向你改过的仓库路径
- 报错 UnsupportedClassVersionError?一定是 JDK 和 Spring Boot 版本不匹配,回第一步核对
- 访问 /hello 返回 404?检查 HelloController 类是否在主启动类的包或子包下(Spring Boot 默认扫描同包及子包)


















