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

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

你是不是经常听说别人在开发网站或后端系统时用的是“Spring Boot”？听起来很高大上的样子。别担心，今天我们就来揭开它的神秘面纱。

Spring Boot 是一个基于 Java 的框架，它可以让开发者非常轻松地创建独立的、生产级的应用程序（尤其是 Web 应用）。你可以把它理解为一个“加速器”，让开发变得更简单、更快速。

使用 Spring Boot，你可以：

• 快速搭建一个网页服务（比如一个博客后台）
• 轻松连接数据库
• 构建 RESTful 接口（就是前后端通信的那种接口）
• 内置服务器，不需要额外部署 Tomcat 等服务器软件
• 自动帮你配置各种功能，节省大量开发时间

说白了，Spring Boot 就是让你少写代码、快速开发的强大工具！

---

二、环境准备：开始前需要安装什么？

在我们开始写代码之前，你需要准备好以下几个工具：

1. 安装 Java 开发环境（JDK）

Spring Boot 是基于 Java 的，所以必须先安装 JDK（Java Development Kit）。

推荐版本：JDK 8 或 JDK 17（目前最常用的长期支持版本）

• Windows 用户：前往 Oracle 官网 下载安装包
• Mac 用户：可以使用命令行安装 brew install --cask adoptopenjdk
• Linux 用户：可以用包管理器安装，如 sudo apt install openjdk-17-jdk

安装完成后，在终端（或命令提示符）中运行下面这个命令检查是否安装成功：

java -version

如果看到类似以下输出，就说明安装成功了：

openjdk version "17.0.1" 2021-10-19
OpenJDK Runtime Environment (build 17.0.1+12-Ubuntu-120.04)
OpenJDK 64-Bit Server VM (build 17.0.1+12-Ubuntu-120.04, mixed mode, sharing)

2. 安装 IDE（推荐 IntelliJ IDEA 或 Eclipse）

IDE 就是写代码的地方，相当于程序员的“办公桌”。

• 推荐使用 IntelliJ IDEA 社区版（免费）
  • 下载地址：https://www.jetbrains.com/idea/download/
• 如果你喜欢轻量级，也可以使用 Eclipse

安装过程很简单，按照提示一步步来就行了。

3. 安装 Spring Boot 插件（如果你用 IntelliJ IDEA）

IntelliJ IDEA 社区版默认不带 Spring Boot 插件，我们可以手动添加：

1. 打开 IntelliJ → File → Settings → Plugins
2. 搜索 “Spring Boot”
3. 安装相关插件（比如 Spring Boot Helper）

✅ 小结一下你需要安装的工具：

工具	作用
JDK	提供 Java 开发环境
IDE（如 IDEA）	编写和管理代码

---

三、核心概念讲解：Spring Boot 的基础结构是怎样的？

为了便于理解，我们来介绍几个最核心的概念，都是你在开发过程中一定会遇到的词。

1. 项目结构：五大重要目录

新建一个 Spring Boot 项目后，你会看到如下文件夹结构：

src/
├── main/
│   ├── java/                ← 放 Java 源代码的地方
│   │   └── com.example.demo/  
│   │       └── DemoApplication.java
│   ├── resources/            ← 存放配置文件、静态资源等
│   │   ├── application.properties
│   │   └── static/
│   └── pom.xml               ← Maven 配置文件（项目管理）

解释一下：

• DemoApplication.java：这是项目的入口类，相当于程序的起点。
• application.properties：用于配置 Spring Boot 的各项参数。
• pom.xml：Maven 项目的核心配置文件，负责管理依赖库。

2. 启动类（Main Class）

每一个 Spring Boot 项目都至少有一个启动类，通常以这样的方式开头：

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

这里的关键是注解 @SpringBootApplication，它告诉 Spring Boot：“从这里开始启动我的应用。”

3. Controller 层（控制器）

Controller 层用来处理前端请求（比如浏览器访问某个网址），比如：

@RestController
public class HelloController {

    @GetMapping("/hello")
    public String sayHello() {
        return "你好，欢迎来到 Spring Boot！";
    }
}

这段代码的作用是当你访问 /hello 这个路径时，会返回一句“你好”的消息。

小贴士：

• @RestController 表示这是一个返回数据的控制器类
• @GetMapping 表示该方法处理 GET 请求
• 返回值会自动转为网页内容输出

4. Maven 与依赖管理

Maven 是一种项目管理工具，它可以自动下载你需要的第三方库。

打开你的 pom.xml 文件，里面有一段像这样的内容：

<dependencies>
    <dependency>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-web</artifactId>
    </dependency>
</dependencies>

这表示你正在使用 Spring Boot 的 Web 功能，Maven 会在你运行项目的时候自动帮你下载所有必需的依赖。

---

四、实战演练：做一个简单的网页服务

现在让我们动手来完成一个简单的 Spring Boot 项目吧！

第一步：新建一个 Spring Boot 项目

推荐使用 Spring Initializr 来生成基础项目结构。

操作步骤：

1. 打开 https://start.spring.io/
2. 填写如下信息：
   • Project: Maven
   • Language: Java
   • Spring Boot Version: 最新稳定版（例如 3.0.x）
   • Group: com.example
   • Artifact: demo
   • Dependencies: Spring Web（勾选）
3. 点击【Generate】按钮下载项目压缩包
4. 解压后用 IntelliJ IDEA 打开即可

第二步：添加 Hello World 接口

打开 src/main/java/com/example/demo 目录，在此处新建一个 Java 类 HelloController.java，然后输入以下代码：

package com.example.demo;

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

@RestController
public class HelloController {

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

第三步：运行程序

点击 DemoApplication.java 文件中的运行按钮，或者使用终端执行命令：

./mvnw spring-boot:run

等待几秒后，你会看到控制台输出：

Tomcat started on port(s): 8080 (http)

表示你的服务器已经运行起来了！

第四步：访问网页

打开浏览器，输入：

http://localhost:8080/hello

你应该会看到页面上显示：

Hello, Spring Boot!

🎉 成功啦！

---

五、新手常见问题解答（FAQ）

Q1：启动时报错，提示找不到类怎么办？

可能原因：

• 依赖没加载好
• Maven 没有正确初始化

解决办法：

1. 在 IDEA 中点击 “Reimport All Maven Projects”
2. 或者使用命令重新加载依赖：

   ./mvnw dependency:resolve
   

Q2：修改完代码不会自动重启？

Spring Boot 默认每次都要手动关闭再启动很麻烦，可以加入热重载（Hot Restart）：

步骤如下：

1. 添加依赖到 pom.xml：

<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-devtools</artifactId>
    <optional>true</optional>
</dependency>

2. 保存文件后，Maven 会自动下载这个依赖
3. 修改代码后直接保存，Spring Boot 会自动重启，省掉手动操作

Q3：怎么改启动端口号？

打开 application.properties 文件，添加一行：

server.port=9090

这样你的程序就会跑在 http://localhost:9090/ 上了。

Q4：有没有图形界面操作 Spring Boot？

当然可以！IntelliJ IDEA 自带很多 Spring Boot 插件，比如 Spring Boot Dashboard 可以一键运行、调试多个微服务。

---

六、下一步学习建议

你现在已经掌握了 Spring Boot 的基本知识，并且做出了第一个小项目。接下来你可以考虑深入以下方向：

1. 数据库操作

• 学习 JPA + Hibernate
• 使用 Spring Data JPA 快速操作数据库
• 示例：构建一个用户注册登录系统

2. 使用 Thymeleaf 模板引擎

如果你不只是想做 API，还想返回 HTML 页面，Thymeleaf 非常适合入门者。

3. RESTful 接口开发

学习如何设计标准的 API 接口，返回 JSON 格式数据，适合对接移动端或前端框架（如 Vue、React）

4. 日志和异常处理

学会使用 @ControllerAdvice 和 @ExceptionHandler 处理全局异常，以及记录日志（如使用 Logback）

5. 项目部署

• 学会打包成 jar 包运行
• 部署到 Linux 服务器（如 Ubuntu）
• 配合 Nginx 做代理

---

结语：坚持练习才是王道！

恭喜你完成了这篇《Spring Boot入门教程》，希望你能感受到后端开发的乐趣。

记住一句话：“多敲代码比什么都管用！”

如果你对本教程有任何疑问，或者想要更多进阶的学习资料，欢迎随时提问！

继续加油吧，未来的大神 🌟