Spring Boot 入门教程:60分钟快速上手
一、Spring Boot 是什么,它能做什么?

Spring Boot 是一个基于 Java 的开发框架,它的核心目标是简化 Spring 应用的创建和部署过程。想象一下你要做一份炒饭,原来的方式是你得先去买米、洗米、切菜、准备锅灶……而 Spring Boot 就像是你直接点外卖——一切都被默认配置好了,开箱即用。
使用 Spring Boot,你可以:
- 快速搭建 Web 应用
- 构建 RESTful API 接口
- 集成数据库(如 MySQL)
- 实现前后端分离项目的后端部分
- 搭建微服务架构等
一句话总结:Spring Boot 是帮你从零起步快速做出可用项目的利器。
二、环境准备:我们都需要哪些工具?

为了顺利学习 Spring Boot,请准备好以下开发环境。我们将一步步带你安装与配置。
1. 安装 JDK(Java 开发工具包)
Spring Boot 基于 Java 运行,因此我们需要安装 JDK(Java Development Kit)。
推荐版本:JDK 17 或 18,企业级项目普遍支持这个版本。
步骤如下:
- 下载地址:https://www.oracle.com/java/technologies/javase-downloads.html
- 安装完成后,在终端(或命令行)中输入:
java -version - 显示类似下面的内容说明安装成功:
openjdk version "17.0.5" 2022-10-18
2. 安装 IntelliJ IDEA(IDE,集成开发环境)
IntelliJ IDEA 是目前最流行的 Java 开发工具,支持自动补全、代码检查、一键运行等强大功能。
步骤如下:
- 下载社区版(免费):https://www.jetbrains.com/idea/download/
- 安装并启动
- 界面打开后会提示创建新项目
✅ 小贴士:如果觉得复杂,也可以使用 Eclipse + STS(Spring Tool Suite),但 IDEA 更推荐新手使用。
3. 创建第一个 Spring Boot 项目(在线方式)
我们可以借助官方提供的 Spring Initializr 在线工具来生成初始项目结构。
步骤如下:
- 打开网址:https://start.spring.io/
- 填写以下信息:
- Project: Maven
- Language: Java
- Spring Boot Version: 3.x(选择稳定版本)
- Group: com.example
- Artifact: demo
- Name: demo
- Package name: com.example.demo
- 在 “Dependencies” 中添加如下依赖:
- Spring Web(Web 应用支持)
- 点击底部按钮【Generate】下载 ZIP 文件
- 解压该文件,并用 IntelliJ IDEA 打开这个文件夹即可
三、Spring Boot 的核心概念详解

初学者常常会对一些术语感到困惑,比如 “MVC”、“Bean”、“Controller”。我们换种更容易理解的说法来讲解这些核心概念。
1. Controller(控制器)是什么?
可以把它看作是一个“接待员”,专门负责接收用户的请求,并返回结果。
例如用户访问 /hello 页面,Controller 负责说:“哦,他想看 hello 页面!”然后告诉系统要展示的内容。
示例代码:
@RestController
public class HelloController {
@GetMapping("/hello")
public String sayHello() {
return "Hello, Spring Boot!";
}
}
当你运行应用并访问 http://localhost:8080/hello,就能看到页面显示:
Hello, Spring Boot!
2. Bean(容器管理的对象)
Bean 是 Spring 管理的一个对象。你可以理解为 Spring 帮你造了一个零件,你只需要“拿来用”。
示例代码:
@Component
public class MyService {
public String getGreeting() {
return "This is a greeting from the service.";
}
}
在 Controller 中调用它:
@RestController
public class HelloController {
@Autowired
private MyService myService;
@GetMapping("/greet")
public String greetUser() {
return myService.getGreeting();
}
}
访问 http://localhost:8080/greet 即可看到输出。
3. AutoConfiguration(自动配置)
这就是 Spring Boot 强大的地方之一:很多东西你不需要手动去配置,Spring Boot 自动替你搞定。
比如你加上 spring-boot-starter-web 后,Tomcat 就被自动引入了;你就不用再手动写 Tomcat 的依赖和配置。
四、实战项目:做一个简单的用户查询系统
我们通过一个小项目来巩固所学知识。我们要做一个简单的用户查询接口:可以按 ID 查询用户信息。
第一步:新建模型类 User.java
这代表一个用户实体。
package com.example.demo.model;
public class User {
private int id;
private String name;
// 构造方法、Getter 和 Setter 省略
public User(int id, String name) {
this.id = id;
this.name = name;
}
public int getId() {
return id;
}
public void setId(int id) {
this.id = id;
}
public String getName() {
return name;
}
public void setName(String name) {
this.name = name;
}
}
第二步:创建 UserService 类,模拟数据库操作
package com.example.demo.service;
import com.example.demo.model.User;
import org.springframework.stereotype.Service;
import java.util.HashMap;
import java.util.Map;
@Service
public class UserService {
private Map<Integer, User> users = new HashMap<>();
public UserService() {
users.put(1, new User(1, "Alice"));
users.put(2, new User(2, "Bob"));
}
public User getUserById(int id) {
return users.get(id);
}
}
第三步:编写 UserController 类,暴露接口
package com.example.demo.controller;
import com.example.demo.model.User;
import com.example.demo.service.UserService;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.web.bind.annotation.*;
@RestController
@RequestMapping("/users")
public class UserController {
@Autowired
private UserService userService;
@GetMapping("/{id}")
public User getUser(@PathVariable int id) {
return userService.getUserById(id);
}
}
第四步:运行并测试接口
- 运行你的项目:点击 IDE 的绿色运行按钮 ✅
- 浏览器访问:
http://localhost:8080/users/1
你会看到 JSON 格式的输出:{"id":1,"name":"Alice"}
🎉 恭喜!你现在完成了一个完整的 Spring Boot 接口服务!
五、常见问题解答
问题 1:为什么不能访问我的接口?总是 404?
可能是 URL 路径错误。
- 检查
@RequestMapping和@GetMapping的组合路径是否拼写正确 - 查看控制台是否有日志输出,提示“mapped to”哪个路径
问题 2:Could not autowire. No beans of 'UserService' type found.
说明 Spring 没有找到对应的 bean。请检查:
- 是否忘记加
@Service注解 - 是否在正确的包下(Spring Boot 默认只扫描主类所在包下的子包)
问题 3:如何修改服务器端口?
打开 application.properties 文件,添加一行:
server.port=9090
重新运行后,将通过 http://localhost:9090 访问你的项目。
问题 4:我写的代码没问题,但编译报错怎么办?
可能是 Maven 包没下载好,试试:
- 刷新 Maven 依赖(右键项目 → Maven → Reload Project)
- 检查网络连接是否正常
六、下一步学习建议
你现在已经完成了 Spring Boot 的入门之旅,可以尝试更深入的学习:
1. 学习数据库连接(如 MySQL)
加入 spring-boot-starter-data-jpa,使用 JPA 操作数据库,构建真正的数据管理系统。
2. 学习 RESTful API 设计规范
尝试构建符合 REST 规范的 API,让前端工程师更喜欢与你合作 😄
3. 学习 Spring Boot 的单元测试
学会使用 JUnit 写测试,确保程序逻辑无误。
4. 学习部署 Spring Boot 应用
了解如何打包为 .jar 文件,部署到 Linux 服务器上。
总结:Spring Boot 学完能干嘛?
掌握 Spring Boot 后,你将能够:
- 快速搭建后台服务
- 构建企业级项目原型
- 支撑前后端分离的后端开发
- 成为一名合格的 Java 后端程序员
现在,你已经有能力写出自己的简单 API 接口,离正式进入后端开发的大门又近了一步!
🚀 继续加油吧,未来属于动手写代码的人!

评论 0