今天咱们从最基础的实操开始，带大家快速上手 SpringBoot 3.x —— 不用复杂配置，不用多余依赖，只用 10 行核心代码，就能搭建一个能直接访问的 REST API，新手也能跟着一步到位。

先说明下前提：咱们默认你已经装好 JDK 17（SpringBoot 3.x 最低要求 JDK 17，别装错版本！）、Maven 和 IDE（IDEA 最佳，Eclipse 也能凑活），如果还没装，评论区扣“环境”，我单独发一期快速搭建教程。

第一步：创建 SpringBoot 3.x 项目

新手不推荐手动建文件夹、写 pom.xml，太容易出错，优先用官方工具一键生成，步骤如下：

1. 打开 Spring 官方初始化地址：https://start.spring.io/（不用科学上网，国内能直接访问）

2. 填写基础配置（跟着填，别瞎改）：

• Project：Maven（Gradle 新手暂时不推荐，后续再讲区别）

• Language：Java

• Spring Boot Version：选最新的稳定版（比如 3.2.4，别选 SNAPSHOT 快照版，不稳定）

• Group：随便填（比如 com.xxx，xxx 换成你的名字缩写）

• Artifact：first-springboot-api（项目名，英文小写，别加空格）

• Package name：默认和 Group+Artifact 一致，不用改

• Java：17（必须选 17，否则 SpringBoot 3.x 跑不起来）

1. 添加依赖（只加一个，多了没用）：

搜索「Spring Web」，勾选上（这是构建 Web 项目、实现 REST API 的核心依赖，勾选后 Maven 会自动下载相关 jar 包）。

1. 点击「Generate」，下载压缩包，解压后用 IDEA 打开（打开时选择 Maven 项目，等待依赖加载完成，右下角提示“Build Success”就ok）。

⚠️ 注意：如果依赖加载很慢，去 settings 里把 Maven 镜像换成阿里云的（百度“IDEA Maven 阿里云镜像配置”，一步就能改，改完秒加载）。

第二步：写 10 行核心代码，实现 REST API

项目加载完成后，找到主启动类（FirstSpringbootApiApplication.java），不用动它，在同一个包下，新建一个 Java 类，命名为「HelloController」（命名规范：首字母大写，结尾加 Controller，固定写法）。

直接复制下面的代码，粘贴到 HelloController 里，注释我已经写得很详细，新手也能看懂：

1// 导入必要的注解（不用手动写，IDEA 会自动导入，没有就按 Alt+Enter 快捷键）
2importorg.springframework.web.bind.annotation.GetMapping;
3importorg.springframework.web.bind.annotation.RestController;
4
5// 标识这个类是控制器，专门处理前端请求，返回 JSON 数据
6@RestController
7publicclassHelloController{
8
9// 定义一个 GET 请求接口，路径是 /hello（访问时用这个路径）
10@GetMapping("/hello")
11publicStringsayHello(){
12// 接口返回的内容，这就是我们要的 REST API 响应
13return"Hello SpringBoot 3.x! 我的第一个 REST API 成功啦～";
14}
15}

count 一下代码：除去注释和空行，核心代码刚好 10 行（@RestController 1行、类定义1行、@GetMapping 1行、方法定义1行、return 1行，再加上必要的括号和导入，不多不少）。

⚠️ 踩坑提醒：类必须和主启动类在同一个包下（比如主启动类在 com.xxx，HelloController 也在 com.xxx 下），否则 Spring 扫描不到，接口会访问失败。

第三步：启动项目，测试 API

1. 找到主启动类（FirstSpringbootApiApplication.java），点击类左边的绿色三角（运行按钮），启动项目。

2. 启动成功的标志：控制台会打印 “Started FirstSpringbootApiApplication in xxx seconds”（没有报错，出现这个提示就说明启动成功）。

3. 测试接口：

打开浏览器，输入地址：http://localhost:8080/hello（8080 是 SpringBoot 默认端口，没改配置的话就是这个），按下回车，就能看到我们返回的内容：

Hello SpringBoot 3.x! 我的第一个 REST API 成功啦～

到这里，你的第一个 SpringBoot 3.x REST API 就搭建完成了！是不是比想象中简单？

新手常见问题（必看，避开90%的坑）

1. 启动报错 “Java version 1.8 is not supported”：说明 JDK 版本太低，换成 JDK 17 即可（别用 8 版本，SpringBoot 3.x 不兼容）。

2. 浏览器访问 404：检查 HelloController 是不是和主启动类在同一个包下；检查 @RestController、@GetMapping 注解有没有漏写；检查访问路径是不是 /hello（别多写斜杠，别少写）。

3. 依赖加载失败：换阿里云 Maven 镜像，或者重启 IDEA，重新加载 Maven 依赖（IDEA 右侧 Maven -> 点击刷新按钮）。