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

---

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

1.1 什么是 Spring Boot？

Spring Boot 是一个建立在 Spring 框架之上的简化开发框架。它的目标是让开发者更快更轻松地构建基于 Java 的 Web 应用。

简单来说，使用 Spring Boot 可以：

• 快速搭建项目结构
• 自动配置常用的组件（比如数据库连接、服务器等）
• 极大地减少样板代码的编写

你可以把它看作是一个“全自动洗衣机”，而传统 Spring 就像一个需要你亲自接水管、调温度的半自动洗衣机。

1.2 我能用它做什么？

使用 Spring Boot 可以用来开发：

• Web 网站后端接口（API）
• 微服务架构应用
• RESTful API 接口
• 数据库操作服务
• 后台管理系统
• 移动 APP 的后台服务

总之，它是构建现代 Java Web 项目的首选工具。

---

二、环境准备：让我们先准备好开发工具

为了顺利运行我们的第一个 Spring Boot 项目，我们需要安装以下几样东西：

2.1 安装 Java 开发工具包（JDK）

Spring Boot 要求至少 Java 8，建议使用 JDK 17 或更新版本。

常见问题：Java 和 JDK 是什么关系？

简单说，Java 是语言，JDK 是开发 Java 程序所需的全套工具。

下载地址：
https://www.oracle.com/java/technologies/javase-downloads.html

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

java -version
javac -version

输出类似下面的内容就表示成功了：

openjdk version "17.0.7" 2023-04-18
OpenJDK Runtime Environment (build 17.0.7+8-Ubuntu-0ubuntu120.04)
OpenJDK 64-Bit Server VM (build 17.0.7+8-Ubuntu-0ubuntu120.04, mixed mode, sharing)

2.2 安装开发工具（IDE） —— IntelliJ IDEA 或 Eclipse

推荐新手使用 IntelliJ IDEA 社区版（免费）

• 下载地址：https://www.jetbrains.com/idea/download/
• 安装步骤略，一路 Next 即可

2.3 创建 Spring Boot 项目（方式一：通过 Spring Initializr）

我们可以直接访问官方网站创建 Spring Boot 项目：

👉 https://start.spring.io

操作步骤如下：

1. Project：选择 Maven（默认）
2. Language：Java（默认）
3. Spring Boot Version：选择稳定版本（如 3.1.x）
4. Project Metadata
   • Group：com.example（组织名）
   • Artifact：demo（项目名）
   • Name：DemoApplication（类名）
5. Dependencies：
   • Spring Web（Web 服务支持）
   • Spring Data JPA（如果我们要使用数据库）

点击按钮 Generate，将自动生成并下载一个 ZIP 文件，解压后导入你的 IDE 中即可。

---

三、核心概念：理解几个最重要的概念

3.1 Spring Boot 应用的基本结构

一个典型的 Spring Boot 项目结构如下：

src/
├── main/
│   ├── java/
│   │   └── com.example.demo/
│   │       ├── DemoApplication.java    # 主程序入口
│   │       └── controller/             # 存放控制器类（处理 HTTP 请求）
│   │            HelloController.java
│   │       └── model/                  # 实体类
│   │            User.java
│   │       └── repository/             # 数据持久化接口
│   │            UserRepository.java
│   │
│   └── resources/
│       └── application.properties      # 配置文件

3.2 最重要的几个术语解释

术语	解释
Controller	控制器，用于处理客户端的请求（比如浏览器访问的 URL）
Service	业务逻辑层，处理具体业务逻辑（比如计算价格、验证用户等）
Repository	数据访问层，负责与数据库交互（存储和读取数据）
Model / Entity	代表数据库中的一张表或一个对象

3.3 “启动类”的作用：@SpringBootApplication

每个 Spring Boot 项目都需要一个主类，通常命名为 XXXApplication.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 方法是程序的入口点，执行时会启动内嵌的 Tomcat 服务器

---

四、实战项目：创建一个“Hello World”网页

我们来完成一个简单的 Spring Boot 项目：实现一个返回 Hello Spring Boot! 的网页。

4.1 第一步：创建控制器类

在 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!";
    }
}

代码解释：

• @RestController 表示这是一个控制器类，所有方法返回的字符串都会直接作为响应内容。
• @GetMapping("/hello") 指定访问 /hello 这个路径时，调用该方法。

4.2 第二步：运行项目

在 IDE 中找到主类 DemoApplication.java，右键选择 Run 'DemoApplication'。

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

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

表示服务器已经启动成功！

4.3 第三步：访问页面

打开浏览器，访问地址：

http://localhost:8080/hello

你应该能看到：

Hello Spring Boot!

✅ 成功啦！你刚刚完成了一个 Spring Boot 的 Web 应用！

---

五、扩展练习：加上一个 JSON 接口返回用户名

有时候我们希望返回的是 JSON 格式的数据（比如给前端或者 APP 提供接口），我们可以这样写：

5.1 新建一个模型类 User.java

package com.example.demo.model;

public class User {
    private String name;
    private int age;

    public User(String name, int age) {
        this.name = name;
        this.age = age;
    }

    // Getter and Setter
    public String getName() {
        return name;
    }

    public void setName(String name) {
        this.name = name;
    }

    public int getAge() {
        return age;
    }

    public void setAge(int age) {
        this.age = age;
    }
}

5.2 修改控制器类，添加一个 JSON 接口

修改 HelloController.java，加入一个新的方法：

@GetMapping("/user")
public User getUser() {
    return new User("Tom", 25);
}

再次运行项目后，访问：

http://localhost:8080/user

结果应该是一个 JSON 数据：

{
  "name": "Tom",
  "age": 25
}

✅ 太棒了！你现在不仅能做 HTML 页面，还能提供 JSON 接口，为前后端分离项目打基础。

---

六、常见问题 FAQ

6.1 为什么访问 localhost:8080/hello 显示 404？

• 检查控制器类有没有 @RestController 注解
• 检查请求路径是否拼写正确（区分大小写）
• 查看启动日志中是否有类似以下提示：

Mapped GET /hello onto public java.lang.String com.example.demo.controller.HelloController.sayHello()

没有的话说明没扫描到这个类。

解决办法：确保包层级是正确的，例如主类在 com.example.demo，而你的控制器也在 com.example.demo.controller，这样才能被扫描到。

6.2 如何修改服务器的端口号？

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

server.port=9090

再重启项目，访问 http://localhost:9090/hello

6.3 我想在页面返回 HTML 页面怎么做？

本教程中我们用的是 @RestController，如果你想返回 HTML 内容（比如静态页面），可以使用 @Controller + Thymeleaf 或其他模板引擎，这部分我们会在进阶教程中讲。

---

七、学习建议：接下来我该学什么？

恭喜你完成了第一个 Spring Boot 项目！这是非常棒的开始。下面是一些建议继续深入学习的方向：

✅ 第一步：掌握更多注解

• @PostMapping
• @RequestMapping
• @PathVariable
• @RequestParam

这些可以帮助你构建更复杂的接口。

✅ 第二步：学习如何连接数据库（Spring Data JPA）

学会使用 Spring Boot 连接 MySQL、PostgreSQL 等数据库，进行增删改查操作。

✅ 第三步：了解 Spring Boot 的自动配置机制

理解 Spring Boot 是如何根据依赖自动配置各种功能的。

✅ 第四步：学习使用 Swagger 生成文档

Swagger 是一个 API 文档工具，可以让前端开发者清楚知道你能提供哪些接口。

✅ 第五步：部署项目到服务器（如云主机）

把你的项目打包成 .jar 文件，上传到阿里云、腾讯云等服务器运行。

---

总结：Spring Boot 真的不难！

本文介绍了从零开始搭建 Spring Boot 环境，并完成了一个简单的 Web 项目，你还学会了返回文本和 JSON 数据。整个过程不需要你有太多 Java 经验，只需要跟着步骤操作就能跑起来。

记住：Spring Boot 并不可怕，它只是帮助你快速写出功能完整的 Web 项目。

下一步就是动手多练，尝试做一个“学生信息管理系统”、“博客系统”这样的小项目，你一定能很快上手！

如果你喜欢这类教程，欢迎持续关注我的专栏《Spring Boot 快速入门系列》，我会带你一步步成长为一名合格的后端工程师 😊

---

总字数约：3098 字