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

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

1.1 什么是Spring Boot？

Spring Boot 是由 Spring Framework 衍生出来的开源项目，它简化了Spring应用的搭建和开发过程。你可以把它理解为一个“工具包”，帮你快速搭建起一个可以直接运行的Java应用程序。

简单来说，Spring Boot 让你不用再写繁琐的配置代码，也不需要自己去集成各种第三方库，一切都可以通过“开箱即用”的方式完成。

1.2 能用来做什么？

Spring Boot 主要用于开发 后端服务（Web服务），比如：

• 接收用户注册请求
• 查询数据库并返回结果
• 提供API接口给前端调用
• 实现登录、权限控制等常见功能

换句话说，它是互联网公司里程序员们每天都在使用的主流技术之一。

---

二、环境准备：搭建开发环境（适合新手）

开始学习之前，我们需要准备好开发环境。以下是最基础的几个工具：

2.1 安装JDK（Java Development Kit）

Spring Boot 是基于 Java 的，所以你需要安装 JDK。推荐使用 JDK 8 或 17。

Windows 下安装：

1. 去官网下载 https://www.oracle.com/java/technologies/downloads/
2. 运行安装程序
3. 设置系统环境变量 JAVA_HOME

验证是否安装成功：

在命令行输入：

java -version
javac -version

如果有输出版本号说明安装正确。

2.2 安装IDE（推荐IntelliJ IDEA）

推荐使用 IntelliJ IDEA Community Edition（社区版），免费又好用。

安装步骤：

1. 前往官网 https://www.jetbrains.com/idea/download/
2. 下载社区版
3. 安装完成后打开即可

2.3 创建第一个Spring Boot项目（在线生成）

为了快速开始，我们可以使用 Spring Initializr 在线工具生成项目骨架：

访问网址：https://start.spring.io/

操作步骤：

1. Project 选择 Maven（默认）
2. Language 选择 Java（默认）
3. Spring Boot Version 选择最新的稳定版本（如 3.0.x）
4. Group 输入你的组织名，比如 com.example
5. Artifact 输入项目名称，比如 demo
6. 点击右侧 Add Dependencies 添加依赖：
   • Spring Web（用于构建网页或API）
   • Spring Boot DevTools（热部署工具，自动重新加载变化）
7. 点击下方按钮 Generate 下载项目压缩包

解压到本地文件夹，并用 IntelliJ IDEA 打开该项目。

2.4 运行第一个Spring Boot程序

在IDE中找到主类（通常叫 DemoApplication.java），点击运行按钮或者右键 → Run，程序就会启动起来。

你会在控制台看到类似下面的输出：

Started DemoApplication in 2.1 seconds (process running on port 8080)

说明程序已经成功运行，正在监听 8080 端口！

---

三、核心概念：通俗易懂地讲清楚关键点

3.1 Spring Boot项目的结构（Hello World）

我们先来看一下Spring Boot项目的目录结构：

src
├── main
│   ├── java
│   │   └── com.example.demo
│   │       ├── DemoApplication.java
│   │       └── controller
│   │            └── HelloController.java
│   └── resources
│       └── application.properties
└── test
    └── ...

• DemoApplication.java：整个项目的入口，相当于程序的“开关”
• controller/HelloController.java：我们将在这里写第一个网页接口
• application.properties：全局配置文件，可以设置服务器端口等参数

✅ 初学者建议：尽量保持包名统一（如 com.example.demo 开头）

3.2 Controller类：处理请求的核心组件

我们来写一个最简单的接口。

新建一个类：HelloController.java，内容如下：

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, Spring Boot!";
    }
}

这段代码的意思是：

• 当用户访问 /hello 这个路径时
• 程序会执行 sayHello() 方法
• 返回字符串 "Hello, Spring Boot!"

保存后重启项目（或使用DevTools自动刷新），然后在浏览器中输入：

http://localhost:8080/hello

你应该能看到页面显示：

Hello, Spring Boot!

🎉 恭喜！你已经写出了自己的第一个Spring Boot接口！

3.3 application.properties：配置文件的作用

我们可以修改端口等设置，在 resources/application.properties 中加入：

server.port=8081

重启项目后，访问地址就变成：

http://localhost:8081/hello

这个文件非常实用，以后我们会用它来设置数据库连接、日志级别等参数。

---

四、实战项目：创建一个简单的学生信息管理接口

我们来做个小项目——实现一个简易的“学生管理系统”。

4.1 新建Student实体类

我们先定义一个“学生”类，放在 model 包下：

package com.example.demo.model;

public class Student {
    private Long id;
    private String name;
    private int age;

    // 构造函数、getters 和 setters 省略，可自动生成
}

4.2 编写REST控制器

接下来编写处理GET请求的接口：

package com.example.demo.controller;

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

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

@RestController
@RequestMapping("/students")
public class StudentController {

    List<Student> students = new ArrayList<>();

    public StudentController() {
        students.add(new Student(1L, "张三", 20));
        students.add(new Student(2L, "李四", 22));
    }

    @GetMapping
    public List<Student> getAllStudents() {
        return students;
    }

    @GetMapping("/{id}")
    public Student getStudentById(@PathVariable Long id) {
        return students.stream()
                .filter(s -> s.getId().equals(id))
                .findFirst()
                .orElse(null);
    }
}

现在启动程序，访问：

• 查看所有学生：http://localhost:8080/students
• 查看某位学生：http://localhost:8080/students/1

你就能看到JSON格式的数据输出了！

4.3 小结：我们的项目具备了哪些功能？

功能	实现方式
显示学生列表	GET /students
查看单个学生信息	GET /students/{id}

虽然只是两个接口，但这正是Spring Boot的强大之处：代码简洁、逻辑清晰、快速见效。

---

五、常见问题解答（FAQ）

Q1：运行时报错 Could not find or load main class

✅ 解决办法：检查运行配置中的 Main Class 是否正确，确保主类（包含 main 方法的类）被选中。

Q2：无法访问 localhost:8080 页面

✅ 解决办法：

• 检查项目是否运行成功
• 查看控制台有没有报错信息
• 换个端口试试（修改 application.properties 文件）
• 浏览器尝试清空缓存

Q3：@RestController 注解有什么用？

✅ 简单说：加了这个注解的类，里面的每个方法返回的内容都会直接作为响应体（比如字符串或JSON），而不是跳转页面。

如果换成 @Controller，那你就得配合视图引擎（如Thymeleaf）来渲染HTML页面了。

---

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

恭喜你完成了本教程的学习！你现在具备了 Spring Boot 基础能力。以下是推荐继续深入的方向：

6.1 数据库存储数据

学习如何连接数据库（如 MySQL）：

• 引入依赖 spring-boot-starter-data-jpa
• 创建 Repository 接口
• 使用 ORM 技术（如 Hibernate）操作数据

6.2 RESTful API 设计规范

了解更专业的接口设计方法：

• HTTP方法（GET/POST/PUT/DELETE）
• 状态码（200 OK, 404 Not Found, 400 Bad Request）
• 统一返回格式（如包装成 {code: 0, data: {...}} 格式）

6.3 Spring Security（安全控制）

学习用户认证与授权：

• 登录验证
• 角色权限控制
• JWT令牌机制

6.4 日志系统 + 单元测试

提升代码质量：

• 使用 SLF4J + Logback 输出日志
• 编写 JUnit 单元测试
• 掌握断言、Mock对象等测试技巧

---

结语：坚持就是胜利

你已经掌握了 Spring Boot 最基本的使用方式。虽然这只是冰山一角，但只要你保持练习、不断实践，很快就能做出完整的Web应用。

记住一句话：

“编程不是学出来的，是做出来的。”

祝你在学习的路上越走越远，早日成为独当一面的全栈开发者！

---

🌟 附录：完整项目GitHub示例 （此处可插入一个简化的GitHub仓库链接，或提醒读者参考官方文档）

如果你喜欢本教程，请点赞收藏分享支持我继续创作更多优质教学内容！