spring boot 是让 spring 开箱即用的工程化封装,5 分钟内可跑起 web 服务:需 jdk 17(adoptium temurin)、maven 3.8.8+ 或 gradle 8.7,通过 start.spring.io 选 spring boot 3.2.8 + spring web 生成项目,ide 自动导入后运行主类即可。

想在5分钟内跑起一个可执行的Java Web服务,不用写XML、不配Tomcat、不折腾依赖版本冲突——Spring Boot就是为此而生。它不是另一个框架,而是让Spring真正“开箱即用”的工程化封装,从JDK环境到第一个@RestController,每一步都必须踩准版本与路径的配合点。
确认并安装匹配的JDK
Spring Boot 3.x 要求 JDK 17 或更高版本;若你选的是长期支持且资料最全的 Spring Boot 2.7.x,则 JDK 8 仍可运行,但【JDK 17 是当前(2026年)生产环境事实标准】,建议直接安装 Adoptium Temurin 17(非系统自带版本)。
安装后,在终端执行 java -version,输出必须包含 “17.” 字样;同时检查 javac -version 输出是否一致——二者版本不一致会导致 Maven 编译失败,且IDE中无法识别模块。
Windows用户需手动设置 JAVA_HOME 指向 jdk-17.x 目录,而非 bin 子目录;Mac/Linux 用户推荐用 sdkman 管理多版本,避免全局污染。
选择构建工具:Maven 或 Gradle
方法一:用 Maven(推荐新手)
下载 Apache Maven 3.8.8+(低于3.8.6存在依赖解析缺陷),解压后配置 MAVEN_HOME 和 PATH;验证 mvn -v 输出含 “Apache Maven 3.8.” 且 Java 版本匹配。
方法二:用 Gradle(适合已有脚本经验者)
直接通过 SDKMAN 安装 Gradle 8.7(Gradle 8.5+ 才完整支持 Spring Boot 3.2 的虚拟线程特性);无需手动配置,sdk install gradle 8.7 即可。
【注意:Spring Initializr 网站生成项目时,Maven 对应 pom.xml,Gradle 对应 build.gradle.kts ——二者不可混用,选错会导致依赖无法解析】
创建第一个 Spring Boot 项目
第一步:打开 https://start.spring.io
第二步:选择 Project:Maven 或 Gradle → Language:Java → Spring Boot 版本:3.2.8(当前最新稳定版)→ Package name:com.example.demo → Artifact:demo
第三步:在 Dependencies 区域勾选 Spring Web(这是唯一必需项,其他如 Lombok、Actuator 可后续添加)→ 点击 Generate → 下载 zip 文件
第四步:解压后用 IntelliJ IDEA 或 VS Code 打开根目录,IDE 会自动识别为 Maven/Gradle 项目;若提示“Enable auto-import”,务必勾选——否则依赖不会下载,启动会报 ClassNotFoundException。
第五步:找到 src/main/java/com/example/demo/DemoApplication.java,右键 → Run ‘DemoApplication’;控制台出现 “Started DemoApplication in X.XXX seconds” 即成功。











