Spring Boot 项目快速搭建与启动的核心是利用 Spring Initializr 工具并确保 JDK 17+、Maven 3.6+ 和 IDEA 环境就绪;通过 IDEA 内置向导创建项目,勾选 Spring Web 等依赖,运行主类后访问 http://localhost:8080 即可验证“Hello Spring Boot!”接口成功。

Spring Boot 项目快速搭建与启动,核心在于利用官方初始化工具 + 合理的环境配置,整个过程通常 3–5 分钟就能跑通第一个接口。关键不是手动写配置,而是让 Spring Boot 自动完成大部分工作。
环境准备:三件套必须到位
缺一不可,否则创建或启动会失败:
-
JDK 17 或更高版本:Spring Boot 3.x 要求 JDK 17+,2.x 可用 JDK 8/11;运行
java -version确认输出版本号 -
Maven 3.6+:用于依赖下载和构建;运行
mvn -v验证,建议在settings.xml中配置阿里云镜像加速 - IDEA(社区版或旗舰版):已内置 Spring Initializr 支持,比手动导入更稳定;检查 Settings → Build → Maven 是否指向正确安装路径
创建项目:推荐 IDEA 内置方式
比访问官网更高效,全程图形化操作:
- 打开 IDEA → File → New → Project
- 左侧选 Spring Initializr,右侧确认 Project SDK 是 JDK 17+,Initializr Service URL 保持默认
https://start.spring.io - 填写元数据:
Group(如com.example)、Artifact(如demo)、Package name(自动生成)、Packaging 选Jar、Java 版本选17 - 关键一步:勾选 Spring Web(Web 项目必需),可顺手加 Spring Boot DevTools(热更新)和 Lombok(简化代码)
启动与验证:两步看到 “Hello World”
项目生成后无需额外配置即可运行:
立即学习“Java免费学习笔记(深入)”;
- 找到
src/main/java/com/example/demo/DemoApplication.java,右键 → Run 'DemoApplication' - 控制台输出
Started DemoApplication in X.X seconds即表示启动成功,默认监听http://localhost:8080 - 新建一个
HelloController.java放在同包下,内容为:@RestController public class HelloController { @GetMapping("/") public String hello() { return "Hello Spring Boot!"; } }保存后刷新浏览器访问
http://localhost:8080,看到文字即验证成功
常见卡点与应对
新手常遇到但容易解决的问题:
-
端口被占用:在
application.properties加一行server.port=8081 - 依赖下载失败:检查 Maven 镜像配置,或 IDEA 中点击右侧 Maven 工具栏 → Reload project
-
404 找不到接口:确认 Controller 类加了
@RestController或@Controller + @ResponseBody,且类在主启动类同包或子包下


















