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

开篇：Spring Boot是什么？

如果你是刚接触Java后端开发的新手，可能会经常听到“Spring”、“Spring Boot”这样的词。那它们到底是什么呢？又有什么作用呢？

简单来说：

• Spring 是一个Java开发框架，帮助开发者更容易地构建企业级应用。
• Spring Boot 是 Spring 的“升级版”，它简化了项目的搭建流程，让开发者可以更快地上手写代码、运行服务。

换句话说，有了 Spring Boot，你不需要再手动配置一大堆繁琐的文件就可以快速启动一个 Web 项目，比如搭建一个博客系统、API 接口服务器等。

---

环境准备：你的第一块拼图

要开始使用 Spring Boot，我们需要先准备好以下工具和环境：

📦 所需工具清单：

工具名称	版本要求	下载地址（部分）
Java JDK	至少JDK 17	https://adoptium.net/zh-CN/temurin/releases/?version=17
IntelliJ IDEA（推荐）	最新社区版或2023.x版本	https://www.jetbrains.com/idea/download/
Maven	自动集成在IDEA中	无需单独下载
Spring Boot CLI（可选）	不强制要求	用于命令行操作

✅ 安装与验证步骤：

步骤一：安装JDK

• 下载并安装 Adoptium 提供的 JDK 17+ 版本
• 验证是否安装成功：

java -version
javac -version

如果看到类似输出则说明成功：

openjdk version "17.0.9" ...

步骤二：安装IntelliJ IDEA

• 建议使用社区版即可
• 安装完成后打开，选择“New Project”

---

核心概念：理解 Spring Boot 的基本组成

虽然我们强调实践，但掌握一些基础术语还是非常有必要的。

🔁 MVC 模式：一种结构化编程方式

MVC 全称 Model-View-Controller，是一种常见于Web开发的结构方式：

层级	负责内容
Model	数据模型，如用户信息类
View	页面展示（前端部分）
Controller	处理请求逻辑，并调用模型生成数据返回给 View

对于我们的第一个小例子，我们暂时只关心 Controller 和最简单的响应数据。

---

实战项目：创建你的第一个 Spring Boot 应用

目标：创建一个能访问 /hello 并显示 “Hello Spring Boot!” 的网页接口。

第一步：创建项目

在 IntelliJ IDEA 中：

1. 点击“New Project”
2. 选择左侧 Spring Initializr
3. 设置如下选项：

Project SDK: 17
Language: Java
Spring Boot Version: 例如 3.2.x
Group: com.example
Artifact: demo
Name: DemoApplication

4. 点击“Next”，不添加任何依赖（初学建议）
5. Finish 完成创建

---

第二步：认识项目结构

创建完成后你会看到几个默认生成的文件夹：

├── src
│   ├── main
│   │   ├── java
│   │   │   └── com.example.demo
│   │   │       ├── DemoApplication.java
│   │   │       └── controller (新建)
│   │   │            └── HelloController.java
│   │   └── resources
│   │       └── application.properties

现在我们要做的就是在 controller 目录下新建一个控制器类来处理请求。

第三步：编写 Hello 请求控制器

新建一个名为 HelloController.java 的类，写入以下代码：

package com.example.demo.controller;

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

@RestController // 表示这是一个响应 JSON 或字符串的控制器
public class HelloController {

    @GetMapping("/hello") // 当访问 /hello 路径时触发该方法
    public String sayHello() {
        return "Hello Spring Boot!";
    }
}

---

第四步：运行程序

回到主类 DemoApplication.java，点击绿色运行按钮，或者右键菜单执行 Run 命令。

控制台会输出类似：

Tomcat started on port(s): 8080 (http) with context path ''

这表示你的服务已经跑起来了！

---

第五步：测试接口

打开浏览器输入：

http://localhost:8080/hello

你应该会看到页面显示：

Hello Spring Boot!

🎉 恭喜你！你已经完成了你的第一个 Spring Boot 程序！

---

常见问题解答（FAQ）

下面整理了一些新手常问的问题和对应的解决方案：

❓ Q1：为什么我运行项目时报错找不到main方法？

✔️ 解决方案：

• 检查主类是否有 @SpringBootApplication 注解
• 确认主类内部有标准入口函数：

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

---

❓ Q2：我在访问路径时提示“404 Not Found”

✔️ 解决方案：

• 检查 URL 是否正确为：http://localhost:8080/hello
• 查看控制器类是否有 @RestController 或 @Controller 注解
• 确保没有拼写错误，大小写敏感！

---

❓ Q3：我需要修改服务器启动端口怎么办？

✔️ 解决方法：

修改 src/main/resources/application.properties 文件：

server.port=9090

重启服务后，将通过 http://localhost:9090/hello 访问。

---

❓ Q4：我能不在IDE里运行 Spring Boot 吗？

✔️ 可以的！

1. 使用 Maven 构建 JAR 包：

mvn clean package

2. 找到生成的 .jar 文件，执行：

java -jar target/demo-0.0.1-SNAPSHOT.jar

---

学习建议：下一步应该做什么？

恭喜你完成了第一个 Spring Boot 程序！但这只是刚刚开始。接下来你可以尝试以下几个方向继续深入学习：

✅ 推荐进阶方向：

1. REST API 开发

   • 学习使用 POST、PUT、DELETE 方法
   • 创建完整的 CRUD 示例（增删改查）

2. 数据库连接

   • 引入 Spring Data JPA + MySQL
   • 连接数据库并实现数据持久化存储

3. 前后端分离

   • 搭配 Vue.js 或 React 做前后端通信
   • 学习 JSON 格式的请求响应处理

4. 部署上线

   • 学习 Docker 部署 Spring Boot 项目
   • 使用 Linux 服务器发布你的应用

---

小结：坚持动手才是进步的关键！

整个教程我们用了不到一个小时的时间就完成了一个 Spring Boot 项目的创建和运行。希望你能感受到它的强大和便利。

记住一句话：“纸上得来终觉浅，绝知此事要躬行。” 在学习过程中多敲代码、多做实验，才能真正掌握这项技术。

如果你对接下来的学习路线还感到迷茫，欢迎留言提问，也可以搜索“Spring Boot 快速开发指南”或“微服务架构入门”作为下一阶段的目标。

祝你成为 Spring Boot 领域的小高手！🚀

---

🎯 动手练习小任务：

在今天结束前，试着在你的项目中新增一个 /hi 路径，让它返回 “Hi, this is my second API!”，然后分享截图或文字记录一下成果吧！