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

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

如果你是刚开始学习后端开发的新手，可能会听说过一个叫做Spring的框架。Spring 是 Java 领域中最流行的应用框架之一，它可以帮助开发者更容易地构建复杂的企业级应用程序。

而今天我们要学习的是它的升级版 —— Spring Boot（发音为“spring boat”）。你可以把它理解成一个“自动化的 Spring”。简单来说，它是一个让开发者快速创建和运行 Spring 应用程序的工具。

🌱 为什么选择 Spring Boot？

• 简化配置：传统 Spring 应用需要很多繁琐的 XML 配置文件，而 Spring Boot 自动帮你完成了大部分基础配置。
• 内置服务器：你不再需要额外安装 Tomcat 或 Jetty 这样的服务器来部署你的应用，Spring Boot 已经内嵌好了。
• 可扩展性强：即使你需要添加数据库支持、安全验证、REST API 等功能，也可以通过简单的依赖配置快速实现。
• 适合初学者：Spring Boot 的自动化机制让你可以快速写出一个“能跑”的项目，从而建立学习信心。

举个例子，如果我们想写一个网站后台程序（比如用户注册、登录等功能），Spring Boot 就能帮我们快速搭建起基础结构，节省大量时间。

---

二、环境准备：搭建开发环境

在开始写代码之前，我们需要准备好必要的开发环境。不要担心，这一步不会太难，跟着做就行！

✅ 所需工具清单：

软件	用途
JDK 17+	Java 开发环境的核心
IntelliJ IDEA（推荐）或 Eclipse	编写 Java 代码的 IDE
Maven	包管理工具，用于下载库（类似 npm）

步骤1：安装 JDK

JDK（Java Development Kit）是编写 Java 程序的必备工具。你可以从 Oracle 官网 或者 OpenJDK 下载并安装 JDK 17 或更高版本。

安装完成后，在命令行中输入以下命令查看是否安装成功：

java -version

输出应类似于：

openjdk version "17.0.8" 2023-07-18

步骤2：安装开发工具（IDE）

推荐使用 IntelliJ IDEA Community Edition（免费版本即可），你可以在官网下载并安装：https://www.jetbrains.com/idea/download/

安装过程一路点击 Next 即可完成。

步骤3：安装 Maven（如未集成）

Maven 是 Spring Boot 默认使用的依赖管理工具。大多数现代 IDE（如 IntelliJ IDEA）已经自带了 Maven 插件，但你可以手动确认一下是否安装正确：

mvn -v

看到类似信息说明已安装：

Apache Maven 3.8.6 (...)
Java version: 17.0.8, ...

如果没有安装，可以从 Maven官网 下载并按照教程安装。

---

三、核心概念讲解：搞懂几个关键术语

Spring Boot 虽然强大，但它背后也有一套自己的术语体系。为了帮助你更好地上手，我们先来认识几个最重要也是最常用的概念。

💡 1. 项目（Project）

项目就像是一座房子的设计图纸，它包含了所有你要写的代码文件和配置文件。Spring Boot 通常使用 Maven 或 Gradle 来组织项目结构。

💡 2. 主类（Main Class）

每个 Spring Boot 应用都有一个启动类，也就是主类。它通常带有一个 @SpringBootApplication 注解，并且包含 main() 方法来运行程序。

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

这是你整个项目的入口点，就像电视机的电源按钮一样重要。

💡 3. 注解（Annotation）

注解就是代码中的小标签，告诉编译器这个类或方法有什么特殊的功能。例如：

• @SpringBootApplication：表示这是一个 Spring Boot 的主类
• @RestController：表示这个类会处理 Web 请求
• @GetMapping("/hello")：表示当用户访问 /hello 地址时，调用这个方法

💡 4. 控制器（Controller）

控制器是用来处理用户的请求的。比如：当用户访问网址 /users，你想显示所有用户数据，那么你就需要一个控制器来处理这个请求。

示例代码如下：

@RestController
public class HelloController {

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

这段代码的意思是：当用户访问网址 /hello，就返回一句问候语。

💡 5. 自动配置（Auto Configuration）

Spring Boot 最强大的地方在于它可以根据你引入的依赖包，自动配置一些功能。比如你加入了一个数据库的依赖包，Spring Boot 就会自动生成数据库连接的配置代码，省去了大量的手动工作。

是不是很神奇？接下来我们就来亲手写一个这样的项目。

---

四、实战项目：做一个简单的“说你好”的Web项目

现在我们就开始一个超简单的 Spring Boot 项目。目标：创建一个网页接口，当你访问 /hello 时，页面上显示一句话：“你好，Spring Boot！”

步骤1：创建项目

使用 start.spring.io 创建项目模板：

1. 浏览器打开：https://start.spring.io/
2. 填写：
   • Project：Maven
   • Language：Java
   • Spring Boot Version：建议选 3.x（最新稳定版）
   • Group：com.example
   • Artifact：demo
   • Name：DemoApplication
   • Packaging：Jar
   • Java：17 或 21
3. 添加依赖项：
   • Spring Web（提供 web 功能）
4. 点击【Generate】按钮下载压缩包

将下载的压缩包解压，并用 IntelliJ IDEA 打开该文件夹。

步骤2：导入并运行项目

1. 打开 IntelliJ IDEA → Open or Import → 选择你解压后的项目文件夹
2. 等待项目加载完成（可能需要几分钟首次加载依赖）
3. 在左侧找到 DemoApplication.java 文件，右键 → Run ‘DemoApplication’
4. 观察控制台输出，如果出现 Started DemoApplication in ... seconds，说明启动成功！

步骤3：创建第一个 Controller（控制器）

我们来添加一个控制器类，让它监听某个网址路径。

在 src/main/java/com/example/demo/controller/ 路径下新建一个 Java 类文件，名称叫 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 "你好，Spring Boot！";
    }
}

步骤4：测试接口

打开浏览器，访问：

http://localhost:8080/hello

你就能看到页面上显示：

你好，Spring Boot！

恭喜你！你的第一个 Spring Boot 程序就这么跑起来了！

---

五、新手常见问题解答

作为一名刚接触 Spring Boot 的新手，很可能在学习过程中遇到各种问题。下面是一些常见问题及解决方法：

❓ Q1：启动报错 “Could not find the main class” 怎么办？

答：这可能是没有正确设置启动类的问题。请检查你的 pom.xml 中 <mainClass> 是否配置正确，或者确保你的主类有 @SpringBootApplication 注解和标准的 main() 方法。

❓ Q2：访问 localhost:8080/hello 提示 404？

答：

• 检查你的 controller 类有没有加上 @RestController 注解
• 检查你的方法有没有加上 @GetMapping("/hello")
• 启动日志里有没有提示 Mapping（映射路径），如 Mapped GET /hello

❓ Q3：怎么改变服务器启动端口？

答：修改 application.properties 文件，加入：

server.port=9090

这样下次启动，服务就会监听在 9090 端口了。

❓ Q4：如何查看当前引入了哪些依赖？

答：打开 pom.xml 文件，其中 <dependencies> 标签下的内容就是你当前项目引用的所有库。

---

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

恭喜你完成了这篇《Spring Boot入门教程》，现在你已经掌握了创建一个简单 Web 接口的能力。接下来你可以尝试更深入的方向：

🔹 1. 学习 RESTful 接口设计

可以学习如何处理 POST、PUT、DELETE 请求，创建完整的用户管理系统、博客系统等。

🔹 2. 加入数据库支持

尝试整合 MySQL、PostgreSQL 等数据库，学习如何保存和读取用户数据。

🔹 3. 使用 Thymeleaf 渲染页面（前后端不分离）

如果你想做出一个带有网页界面的项目，Thymeleaf 是一个非常适合的模板引擎。

🔹 4. 学习 Spring Security 实现权限控制

了解如何实现用户登录、权限认证、Token 授权等功能。

🔹 5. 整合 Swagger 快速生成 API 文档

Swagger 可以帮你自动生成接口文档，方便前后端协作开发。

---

七、总结

本教程从零开始带你了解了 Spring Boot 是什么，为什么要用它，然后一步步搭建开发环境，编写了第一个简单的 Web 接口。

虽然只是一个小项目，但这为你今后的学习奠定了坚实的基础。记住一点：编程不是靠看懂，而是靠动手去做。建议你现在就去尝试改改代码，看看能不能写出不同的接口，或者试着把 /hello 改成 /greet 试试看效果。

坚持练习，下一个厉害的开发者，可能就是你！

🎉 学有所成，请给自己点赞鼓励吧！