Spring Boot入门教程：60分钟快速上手

---

一、开篇：什么是Spring Boot？它能做什么？

你是不是经常听说“Java后端开发”、“企业级应用开发”这些词，但不知道从哪里开始？

别担心！Spring Boot 就是帮你解决这个问题的神器。

Spring Boot 是什么？

简单来说，Spring Boot 是一个基于 Java 的框架，用来快速搭建和开发 Web 应用程序。它是由 Spring Framework 发展而来的，目的是让开发者可以更简单地使用 Spring 来构建项目。

为什么选择 Spring Boot？

• ✅ 不需要手动配置大量 XML 文件
• ✅ 内置服务器（比如 Tomcat），无需自己部署到外部服务器
• ✅ 提供很多现成的“启动器”（Starter），比如连接数据库、安全认证等
• ✅ 社区活跃，资料丰富，适合初学者

它能用来做什么？

你可以用 Spring Boot 做：

• 后台管理系统
• RESTful API 接口服务
• 微服务架构中的模块
• 数据库操作服务（比如增删改查）
• 甚至可以结合前端做完整的网站系统！

下面我们就来一步步带你上手 Spring Boot 开发，只需要60分钟，你就能做出属于自己的第一个 Java Web 程序！

---

二、环境准备：安装必要的工具

要写 Spring Boot 程序，你需要先准备好以下开发环境：

步骤1：安装 Java JDK

JDK（Java Development Kit） 是 Java 程序员必须安装的工具包。

如何安装？

1. 访问官网 https://www.oracle.com/java/technologies/javase-downloads.html
2. 下载最新版本的 JDK（推荐使用 JDK 8 或以上）
3. 按照提示安装
4. 验证安装成功：打开命令行（Windows按 Win+R 输入 cmd，Mac/Linux 打开 Terminal）

java -version

显示如下内容即为成功：

openjdk version "17" ...

---

步骤2：安装 IDEA（推荐IDE）

我们推荐使用 IntelliJ IDEA Community Edition（简称 IDEA），这是 JetBrains 公司出品的专业 Java IDE，社区版免费！

安装步骤：

1. 访问官网：https://www.jetbrains.com/idea/download/
2. 下载适用于你系统的版本
3. 安装完成后打开软件

---

步骤3：验证所有工具是否就绪

在 IDEA 中新建一个空项目，然后打开终端运行：

mvn -v

如果显示 Maven 版本信息，说明环境已经基本就绪！

---

三、核心概念讲解：Spring Boot 的几个重要知识点

1. Spring Boot Starter 是什么？

Spring Boot 通过 Starters（启动器） 提供各种预先集成的功能模块。

例如：

• spring-boot-starter-web：用于构建 Web 应用
• spring-boot-starter-data-jpa：用于数据库操作
• spring-boot-starter-security：用于权限控制

只要你在 pom.xml 中添加对应的 starter，就能自动导入相关依赖并完成默认配置，非常方便！

---

2. 自动配置（Auto Configuration）

传统 Spring 开发需要大量的配置文件（如 XML 和 properties）。而 Spring Boot 利用了自动配置机制，会根据你引入的依赖自动帮你生成基础配置。

比如：

• 当你加入 spring-boot-starter-web，它会自动配置内嵌的 Tomcat 和 DispatcherServlet
• 加入 spring-boot-starter-data-jpa 时，会自动尝试连接数据库并加载 ORM 映射

你也可以修改它的配置，比如换掉默认的数据库或者修改端口号。

---

3. main方法启动类

每一个 Spring Boot 项目都有一个带 @SpringBootApplication 注解的主类，这个类的作用是作为整个项目的入口点。

示例代码如下：

@SpringBootApplication
public class MyApplication {

    public static void main(String[] args) {
        SpringApplication.run(MyApplication.class, args);
    }
}

只要你运行这个 main 方法，Spring Boot 就会自动启动内置的 Web 服务器，开始监听请求！

---

4. Controller 控制器

Controller 就是用来处理 HTTP 请求的组件。你可以把它想象成一个“门卫”，负责接收用户发来的请求，并给出回应。

示例代码：

@RestController
@RequestMapping("/hello")
public class HelloController {

    @GetMapping("/")
    public String sayHello() {
        return "Hello Spring Boot!";
    }
}

当你访问 http://localhost:8080/hello/ 这个 URL 时，就会看到页面上输出 "Hello Spring Boot!"。

---

四、实战演练：做一个简单的 Hello World 项目

接下来我们实际动手创建一个简单的 Spring Boot 项目，实现一个返回欢迎信息的接口。

Step 1：新建 Spring Boot 项目

1. 打开 IntelliJ IDEA
2. 点击 File > New > Project
3. 选择 Spring Initializr
4. 填写 Group、Artifact 名（比如 group: com.example，artifact: helloboot）
5. 添加依赖项：
   • Spring Web（即 spring-boot-starter-web）
6. 点击 Finish，等待下载依赖

---

Step 2：编写第一个 Controller

在 src/main/java/com/example/helloboot/controller/ 包下创建一个新的类：

package com.example.helloboot.controller;

import org.springframework.web.bind.annotation.*;

@RestController
@RequestMapping("/api")
public class HelloController {

    @GetMapping("/hello")
    public String sayHello() {
        return "Hello, Welcome to Spring Boot!";
    }

    @GetMapping("/greet/{name}")
    public String greet(@PathVariable String name) {
        return "Hello " + name + "! Nice to meet you.";
    }
}

解释一下这两个方法：

• @RestController 表示这是一个返回数据而不是视图的控制器
• @RequestMapping("/api") 是这个类下的所有接口的基础路径
• @GetMapping 是简化版的 @RequestMapping(method = RequestMethod.GET)
• @PathVariable 表示 URL 中的一部分会被解析为变量传入方法中

---

Step 3：运行项目并测试

右键点击你的主类（如 HellobootApplication.java） → Run Application

等待项目启动完成后，打开浏览器或 Postman：

访问：

• http://localhost:8080/api/hello —— 返回欢迎语句
• http://localhost:8080/api/greet/Tom —— 返回问候语句

🎉 成功了！你已经完成了第一个 Spring Boot 项目！

---

Step 4：改变端口号

有时候默认的 8080 端口可能被占用，我们可以修改端口。

在 application.properties 文件中添加一行：

server.port=8090

现在重新运行项目，访问地址应该是：

• http://localhost:8090/api/hello

---

五、常见问题解答（FAQ）

❓Q1：启动时报错 “Port 8080 was already in use”

这是因为 8080 端口被其他程序占用了。你可以：

• 修改 server.port 为你想使用的空闲端口
• 使用任务管理器或 lsof -i :8080 查看并关闭占用程序

---

❓Q2：找不到 controller 或 404

请检查：

• 是否加了 @RestController 或 @Controller 注解
• 是否有 @RequestMapping 或 @GetMapping/@PostMapping 配置路径
• 重启项目以确保扫描到了新类

---

❓Q3：Maven 下载很慢，甚至失败

可能是网络原因导致无法从中央仓库下载依赖。

解决方案：

• 改用国内镜像（如阿里云）在 settings.xml 中添加：

<mirrors>
    <mirror>
        <id>aliyun</id>
        <url>https://maven.aliyun.com/repository/public</url>
        <mirrorOf>*</mirrorOf>
    </mirror>
</mirrors>

---

❓Q4：IDEA 中 run 没反应怎么办？

可以尝试：

• 清理项目：Build > Clean Project
• 重建项目：Build > Rebuild Project
• 检查项目 SDK 是否设置正确（File → Project Structure）

---

六、学习建议：下一步怎么学？

恭喜你完成了第一个 Spring Boot 小项目！接下来你可以进一步学习以下内容：

学习路线建议：

学习阶段	学习内容
📘 第一步	深入学习 Spring Boot Web 接口开发：GET / POST / PUT / DELETE 等请求类型
📗 第二步	整合数据库：使用 Spring Data JPA 或 MyBatis 进行 CRUD 操作
📕 第三步	学习 Spring Boot Security 实现登录认证与权限控制
📒 第四步	使用 Thymeleaf 模板引擎展示动态网页
📙 第五步	构建微服务架构（Spring Cloud）

---

推荐学习资源：

• 👉 官网文档：https://docs.spring.io/spring-boot/docs/current/reference/htmlsingle/
• 👉 B站教程：搜索“尚硅谷 Spring Boot”
• 👉 GitHub 示例项目：参考 https://github.com/spring-projects/spring-boot-samples

---

七、小结

今天我们用了不到60分钟的时间，一起完成了：

✅ 安装 JDK + IDEA
✅ 创建第一个 Spring Boot 项目
✅ 编写两个简单的接口
✅ 运行并测试了功能
✅ 解决了一些新手常见的问题

你已经正式跨进了 Spring Boot 的世界，接下来只要坚持学习和实践，成为一名熟练的后端开发者指日可待！

💡 记住一句话：编程不是懂了才去做，而是做了才会懂。

继续加油吧！🚀