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

开篇：Spring Boot 是什么？我能用它做什么？

你有没有想过，如何用 Java 快速开发一个 Web 程序？比如一个简单的博客系统、员工管理系统、或者天气查询接口？传统的 Java 开发往往需要配置很多繁琐的 XML 文件、引入一堆依赖、还要写很多样板代码才能运行起来。

而 Spring Boot 就是为了解决这些问题而诞生的。它是 Spring 框架的一个增强版，目的就是——“开箱即用”，让开发者可以更快地搭建和运行应用程序，减少配置、专注业务。

简单来说，Spring Boot = Spring + 自动配置 + 快速启动工具

为什么你应该学习 Spring Boot？

• ✅ 面向企业级开发，是后端主流技术之一
• ✅ 极大简化了传统 Spring 的配置
• ✅ 可以轻松构建 RESTful API、Web 应用、微服务等
• ✅ 社区活跃，文档丰富，就业市场热门

接下来我们就要带你从零开始，一步步搭建你的第一个 Spring Boot 应用！

---

环境准备：搭建开发环境（15分钟）

在开始编码之前，我们需要先准备好以下工具：

1. 安装 JDK（Java Development Kit）

Spring Boot 基于 Java，所以你必须先安装 JDK。

• 推荐版本：JDK 8 或更高（JDK 17 更佳）
• 下载地址：https://www.oracle.com/java/technologies/downloads/
• 安装完成后，在命令行中输入：

  java -version
  

  看到类似信息说明安装成功：

  openjdk version "17.0.3" 2022-04-19
  

2. 安装 IntelliJ IDEA（推荐）

IntelliJ IDEA 是一个强大的 Java IDE（集成开发环境），对 Spring Boot 支持非常好。

• 社区版免费下载地址：https://www.jetbrains.com/idea/download/
• 安装过程略过，双击安装即可。

3. 创建你的第一个 Spring Boot 项目

访问 https://start.spring.io 这个网址，它是 Spring 官方提供的项目生成器。

按照下图选择：

• Project: Maven
• Language: Java
• Spring Boot Version: 最新稳定版，如 3.0.x
• Group: com.example（这个是你项目的组织名）
• Artifact: demo（这是项目名）
• Name: DemoApplication（主类名）
• Package name: com.example.demo
• Dependencies:
  • Spring Web（用于创建 Web 应用）

点击 GENERATE 按钮下载 zip 包，解压后用 IntelliJ IDEA 打开。

---

核心概念讲解：Spring Boot 关键概念通俗解释（15分钟）

刚开始学 Spring Boot 时，总会遇到一些陌生的术语，下面我用生活中的比喻来帮你理解它们。

🌱 1. 什么是 Spring Boot 启动类？

就像汽车上的点火钥匙，每次启动 Spring Boot 项目，都会从“启动类”开始执行。

文件位置：src/main/java/com/example/demo/DemoApplication.java

内容如下：

package com.example.demo;

import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;

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

📌 记住：

• @SpringBootApplication 注解表示这是一个 Spring Boot 应用
• main() 方法是程序入口点，负责启动整个应用

🌐 2. 什么是 Controller？

Controller 是控制层的意思，用来处理用户的请求。你可以把它想象成“客服中心”，当用户访问某个网页或 API 地址时，就会找 controller 来处理。

例如，你想让用户通过浏览器访问 /hello 看到一句话 “Hello World”。

我们新建一个类：

package com.example.demo.controller;

import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RestController;

@RestController
public class HelloController {

    @GetMapping("/hello")
    public String sayHello() {
        return "Hello World";
    }
}

📌 关键点：

• @RestController 表示这个类会返回 JSON 字符串（而不是 HTML 页面）
• @GetMapping("/hello") 表示当访问 /hello 地址时，调用这个方法

⚙️ 3. 什么是自动配置？

传统 Spring 配置很麻烦，你需要手动配数据库连接池、事务管理器等等一大堆组件。但 Spring Boot 在背后已经帮你搞定这些工作了，这就是它的核心卖点：自动配置（Auto Configuration）

只要你在 pom.xml 中引入相关依赖（比如 Spring Data JPA、MyBatis、MongoDB 等），Spring Boot 会根据类路径自动装配相应的功能模块。

---

实战项目：开发一个简单的图书管理系统（20分钟）

现在我们来做个小项目：图书管理系统！它包含两个功能：

1. 展示所有书籍列表
2. 添加一本书籍

我们将使用 Spring Boot Web 和内存中的数据来实现（不涉及数据库，后续再加）

第一步：创建 Book 类（实体类）

package com.example.demo.model;

public class Book {
    private Long id;
    private String title;
    private String author;

    // 构造函数、getter/setter 省略，可右键 Generate 自动生成
}

提示：在 IntelliJ IDEA 中，选中类属性 → 右键 → Generate → Getter and Setter / Constructor / toString()

第二步：创建 BookController 类（处理请求）

package com.example.demo.controller;

import com.example.demo.model.Book;
import org.springframework.web.bind.annotation.*;

import java.util.ArrayList;
import java.util.List;

@RestController
@RequestMapping("/books")
public class BookController {

    private List<Book> books = new ArrayList<>();

    // 获取全部书籍
    @GetMapping
    public List<Book> getAllBooks() {
        return books;
    }

    // 添加一本新书
    @PostMapping
    public Book addBook(@RequestBody Book book) {
        books.add(book);
        return book;
    }
}

📌 解释几个注解：

• @RestController：控制器类，直接返回 JSON 数据
• @RequestMapping("/books")：基础路径为 /books
• @GetMapping：接收 GET 请求
• @PostMapping：接收 POST 请求
• @RequestBody：接收客户端发送过来的 JSON 数据并转换为对象

第三步：运行项目，测试接口

点击 DemoApplication.java 文件中的 Run 按钮，启动项目。

等待日志输出：

Tomcat started on port(s): 8080 (http)
Started DemoApplication in 3.6 seconds (JVM running for 4.1)

说明服务器已经成功启动，默认端口为 8080。

打开浏览器测试：

测试一：获取书籍列表（GET）

访问：http://localhost:8080/books

此时列表为空。

测试二：添加一本书（POST）

使用 Postman 或浏览器插件发送 POST 请求：

• URL: http://localhost:8080/books
• Method: POST
• Body（JSON）:

{
  "id": 1,
  "title": "Java编程思想",
  "author": "Bruce Eckel"
}

提交后再次访问 /books，就能看到刚添加的书籍了！

🎉 到此为止，你已经完成了一个完整的 Spring Boot Web 接口开发！

---

常见问题答疑（5分钟）

❓1. 访问不到接口怎么办？

• 检查是否启动了项目（控制台有没有报错？）
• 确保访问地址拼写正确：比如 http://localhost:8080/hello
• 检查是否有防火墙设置阻止访问 8080 端口
• 查看启动日志，确认 Tomcat 已启动成功

❓2. 修改了代码没有生效？

• 如果使用的是热部署（devtools），修改后应该能自动重启
• 否则需要手动重新运行 DemoApplication.java 中的 main 方法

❓3. 报错：“NoSuchMethodError”

常见于依赖版本冲突。请检查 pom.xml 文件中各依赖是否兼容。

解决方案：

• 更新 Spring Boot 版本至最新稳定版
• 统一所有依赖项的版本号
• 使用官方推荐的依赖组合

❓4. 我不知道怎么调试代码？

• 在 BookController.java 中打断点（左侧行号边点击）
• 使用 Debug 模式运行程序，查看变量值、流程走向等

---

学习建议：下一步该学什么？（5分钟）

恭喜你完成了 Spring Boot 的初步学习！

接下来，如果你想继续深入学习 Spring Boot，可以参考以下几个方向：

🔹 1. 数据库操作（Spring Data JPA / MyBatis）

• 学会连接 MySQL
• 学会增删改查操作
• 使用 ORM 框架（如 Hibernate、MyBatis）

🔹 2. 前后端分离开发（Vue.js + Spring Boot）

• 学会与 Vue、React 等前端框架配合
• 返回 JSON 数据供前端展示
• 使用 Swagger 编写 API 文档

🔹 3. 安全认证（Spring Security）

• 添加登录权限控制
• 限制某些接口只能登录用户访问

🔹 4. 微服务架构（Spring Cloud）

• 学会将多个独立服务连接在一起
• 掌握 Eureka、Feign、Zuul、Config Server 等常用组件

推荐学习资源：

• ✅ Spring Boot 官方文档：https://docs.spring.io/spring-boot/docs/current/reference/htmlsingle/
• ✅ 免费视频课程：B站搜索 “Spring Boot 教程”
• ✅ GitHub 示例仓库：搜索关键词 springboot example

---

总结：Spring Boot 上手其实很简单！

回顾一下我们在本教程中学到了什么：

内容	目标
安装开发环境	成功创建第一个 Spring Boot 项目
核心概念	了解启动类、Controller、自动配置的作用
实战项目	开发了一个图书管理系统的基础功能
常见问题	能解决初学者常遇到的一些小问题
学习路线	明确下一步要学习的方向

坚持每天练习一点点，Spring Boot 一点也不难。继续加油吧，未来的 Java 工程师！

---

📌 课后作业：

尝试修改 BookController，增加以下功能：

1. 通过 ID 查询某本书（GET /books/{id}）
2. 删除某一本书籍（DELETE /books/{id}）

试试看你能做到吗？欢迎留言交流问题 😊