Spring Boot入门教程:60分钟快速上手
开篇:Spring Boot是什么?我能用它做什么?

如果你是刚开始学编程的新手,听到“Spring Boot”这个词可能有点陌生。别担心,我们慢慢来。
Spring Boot 是一个 Java 框架,它的作用是让你更容易地开发后端程序(也就是网站或应用的服务器部分)。你不用再手动配置很多复杂的设置,Spring Boot 会帮你自动完成这些工作,这样你就可以更专注于写代码本身。
举个简单的例子:
如果你要煮一锅面,你需要准备锅、水、火、调味料……但如果你有一个“自动煮面机”,你只需要按下按钮和放材料,它就会自动处理整个过程。
Spring Boot 就像是这个自动煮面机——简化了 Java 后端开发的过程。
环境准备:搭建你的第一个 Spring Boot 开发环境

所需软件一览:
- Java JDK 17 或以上版本
- IntelliJ IDEA 或 VS Code(推荐初学者用 IntelliJ IDEA 社区版)
- Maven(依赖管理工具,IntelliJ 自带)
第一步:安装 Java JDK
安装完成后,在命令行中输入:
java -version
如果看到类似下面的输出,说明安装成功:
openjdk version "17.0.8" 2023-07-18
第二步:安装 IntelliJ IDEA 社区版
访问官网:https://www.jetbrains.com/idea/download/
选择“Community”版本下载并安装。这是专为 Java 开发而设计的强大编辑器。
第三步:创建第一个 Spring Boot 项目
最简单的方式是使用 Spring 官方提供的工具:Spring Initializr
步骤如下:
- 打开链接 https://start.spring.io/
- 填写以下信息:
- Project: Maven
- Language: Java
- Spring Boot Version: 最新稳定版(如 3.x)
- Group: com.example(你可以改成你喜欢的名字)
- Artifact: demo(项目名)
- 添加依赖项(Add Dependencies):
- Spring Web(用于构建 Web 接口)
- 点击 “Generate” 下载项目压缩包

解压后用 IntelliJ 打开即可开始编写代码!
核心概念:Spring Boot 的几个关键词解释

1. 什么是 Controller(控制器)?
可以理解为“接收请求并给出回应的人”。比如用户在浏览器上访问 /hello,Controller 负责返回“你好”的结果。
示例代码:
@RestController
public class HelloController {
@GetMapping("/hello")
public String sayHello() {
return "你好,世界!";
}
}
这段代码的作用就是:当你访问 http://localhost:8080/hello 时,网页会显示“你好,世界!”
2. 什么是 Spring Boot Starter?
这是一些现成的模块,可以直接加到项目中使用。比如上面添加的 Spring Web 就是一个 Starter,它包含了 Web 开发所需的所有基础功能。
3. 什么是 Main 方法?为什么需要它?
每个 Spring Boot 应用都有一个带有 main() 方法的类,它是程序的启动点。
@SpringBootApplication
public class DemoApplication {
public static void main(String[] args) {
SpringApplication.run(DemoApplication.class, args);
}
}
点击运行这个类,就能启动一个本地服务器。
4. 什么是注解(Annotation)?
Java 中的注解就像是贴在代码上的小标签,告诉编译器一些特殊的信息。
常用注解举例:
| 注解名称 | 作用说明 |
|---|---|
@RestController |
表示这是一个接口控制器 |
@GetMapping("/xxx") |
当访问 /xxx 这个地址时执行某个方法 |
@SpringBootApplication |
标记这是 Spring Boot 的主类 |
实战项目:做一个最简单的“留言本”API
我们现在来做个小项目,实现两个功能:
- 显示所有留言
- 提交一条新留言
第一步:创建模型类(Model)
新建文件:Message.java
public class Message {
private String content;
public Message() {}
public Message(String content) {
this.content = content;
}
public String getContent() {
return content;
}
public void setContent(String content) {
this.content = content;
}
}
第二步:创建一个存储消息的容器类
新建文件:MessageService.java
import java.util.ArrayList;
import java.util.List;
public class MessageService {
private List<Message> messages = new ArrayList<>();
public List<Message> getAllMessages() {
return messages;
}
public void addMessage(Message message) {
messages.add(message);
}
}
第三步:创建 Controller 来处理请求
新建文件:MessageController.java
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.web.bind.annotation.*;
import java.util.List;
@RestController
@RequestMapping("/api/messages")
public class MessageController {
@Autowired
private MessageService messageService;
@GetMapping
public List<Message> getAll() {
return messageService.getAllMessages();
}
@PostMapping
public void add(@RequestBody Message message) {
messageService.addMessage(message);
}
}
第四步:测试 API
启动项目后,可以用以下方式测试:
- 访问:http://localhost:8080/api/messages (GET 请求)查看所有留言
- 使用 Postman 或 curl 发送 POST 请求提交新留言:
{
"content": "这是我的第一条留言"
}
常见问题解答(FAQ)
Q1: 启动时报错:“Port 8080 was already in use”
A: 表示 8080 端口被其他程序占用了。可以在 application.properties 文件中修改端口:
server.port=8081
Q2: 我写了代码但是访问不到接口怎么办?
A: 检查几点:
- Controller 类是否加了
@RestController - 是否有拼写错误,比如
GetMapping写成了GetMappin - 方法有没有加上注解,比如
@GetMapping("/") - 主类是否有
@SpringBootApplication并正常运行
Q3: JSON 格式不正确怎么办?
A: 使用标准的 JSON 格式,注意字段大小写一致。例如上面的例子中字段是 "content",发送数据时也要保持一致。
Q4: 什么是 Maven?为什么要用它?
A: Maven 是一个 Java 的依赖管理工具。你可以理解为:它能帮你自动下载和管理你项目用到的各种库(比如 Spring 的库)。不需要你自己一个个去网上找 JAR 包了。
学习建议:下一步该学什么?
恭喜你已经完成了 Spring Boot 的入门!
接下来建议学习的内容包括:
✅ 第一步:深入学习 RESTful API 设计规范
掌握 GET、POST、PUT、DELETE 四种基本请求类型的区别,并了解如何设计优雅的 API 接口。
✅ 第二步:数据库操作 —— JDBC / MyBatis / Spring Data JPA
把数据保存到数据库而不是内存中。常用的工具有:
- MySQL + JDBC
- Spring Data JPA
- MyBatis
✅ 第三步:前后端交互实践
尝试配合前端框架(如 Vue.js 或 React)进行项目实战。
✅ 第四步:部署上线
学习打包项目为 jar 包、部署到服务器(Linux + Nginx + Tomcat),甚至使用 Docker 部署。
总结
今天我们从零开始学习了 Spring Boot 的基础内容,完成了开发环境搭建、核心概念讲解,以及一个简单的留言本 API 项目。虽然还有很多没有讲到,但这已经足够让你迈出第一步了!
记住一句话:
Spring Boot 不是你必须马上学会的东西,而是你每次写 Java 后端代码都会想用的东西。
持续练习,不断实践,你会越来越得心应手!
如果你觉得这篇文章对你有帮助,欢迎点赞、收藏或转发给更多想学后端的朋友!

评论 0