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

开篇：什么是Spring Boot？它能做什么？

Spring Boot 是一个基于 Java 的框架，由 Pivotal 团队开发。它的最大特点是 “开箱即用” —— 也就是说，你几乎不需要手动配置太多东西就可以开始写代码了。

简单来说，你可以用 Spring Boot 来搭建一个 Web 应用、API 接口、或者后台管理系统。比如你要做一个天气预报网站的后端接口，用 Spring Boot 就非常方便。

Spring Boot 的优势：

• 自动化配置，省去繁琐的 XML 配置文件
• 内嵌服务器（比如 Tomcat），直接运行就能看效果
• 简化依赖管理，使用 Maven 或 Gradle 更加轻松
• 社区庞大，资料丰富，适合初学者和企业级开发

---

环境准备：一步步搭建你的开发环境

在开始写代码之前，你需要准备好以下开发工具：

1. 安装 JDK（Java 开发工具包）

推荐版本：JDK 17 或 JDK 21

下载地址：Oracle官网 或 OpenJDK

安装完成后，在终端输入：

java -version

如果能看到类似如下信息，说明安装成功：

openjdk version "17.0.3" 2022-04-19
OpenJDK Runtime Environment Temurin-17.0.3+7 (build 17.0.3+7)
OpenJDK 64-Bit Server VM Temurin-17.0.3+7 (build 17.0.3+7, mixed mode)

2. 安装 IntelliJ IDEA（Java 编辑器）

推荐使用 IntelliJ IDEA Community Edition（社区版），完全免费。

下载地址：JetBrains 官网

安装完成后，打开 IDE，稍等片刻进入主界面。

3. 创建第一个 Spring Boot 项目

步骤：

1. 打开浏览器访问：https://start.spring.io
2. 填写如下信息：
   • Project: Maven
   • Language: Java
   • Spring Boot Version: 3.x （比如 3.1）
   • Group: com.example
   • Artifact: demo
   • Name: DemoApplication
   • Packaging: Jar
   • Java: 17 或 21
3. 添加依赖：
   • Spring Web
   • Spring Boot DevTools（可选，调试时更方便）
4. 点击 “Generate” 按钮下载项目压缩包

解压后，使用 IntelliJ IDEA 打开这个文件夹即可。

---

核心概念：Spring Boot 的几个关键词解释

即使你是零基础，也能听懂这些专业词汇！

1. Controller（控制器）

你可以把它理解为“处理网页请求的人”。当你在浏览器输入网址时，Controller 就是那个接收请求并给出回应的角色。

代码示例：

@RestController
public class HelloController {
    @GetMapping("/hello")
    public String sayHello() {
        return "Hello, Spring Boot!";
    }
}

这段代码的意思是：当有人访问 /hello 这个网址时，就返回一句 Hello, Spring Boot!

2. Application（启动类）

这是整个程序的入口点，就像游戏里的“开始按钮”。

Spring Boot 默认生成的启动类长这样：

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

只要运行这个类，你的服务就会启动。

3. Dependency（依赖）

依赖就是你写的程序需要用到的外部库。比如上面我们添加的 Spring Web 就是一个依赖，它让我们的项目支持 HTTP 请求。

Maven 会自动从互联网下载这些依赖，你只需要在 pom.xml 文件中声明即可。

---

实战项目：写一个简单的 API 接口

现在我们来实战一下：做一个显示当前时间的接口！

第一步：创建一个 Controller 类

在 src/main/java/com/example/demo 文件夹下新建一个类：

package com.example.demo;

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

import java.time.LocalDateTime;
import java.time.format.DateTimeFormatter;

@RestController
public class TimeController {
    @GetMapping("/time")
    public String getCurrentTime() {
        LocalDateTime now = LocalDateTime.now();
        DateTimeFormatter formatter = DateTimeFormatter.ofPattern("yyyy-MM-dd HH:mm:ss");
        return "当前时间是：" + now.format(formatter);
    }
}

第二步：运行项目

点击 IntelliJ IDEA 右侧边栏的运行按钮（▶️），或者在菜单栏选择 Run > Run 'DemoApplication'

第三步：测试接口

在浏览器中打开下面这个网址：

http://localhost:8080/time

你会看到类似这样的结果：

当前时间是：2025-04-05 10:30:45

恭喜你！你已经完成了一个简单的 Spring Boot Web 接口！

---

常见问题解答：新手常遇到的错误和解决方案

Q1：为什么我的程序无法启动？

可能是以下原因：

• 没有正确安装 JDK
• JDK 版本和 Spring Boot 不兼容（建议用 JDK 17）
• Maven 没有正确下载依赖（可以尝试重启 IDE 或重新导入项目）

Q2：访问 /hello 页面提示404？

请确认：

• 是否漏掉了 @GetMapping 注解
• URL 路径是否拼写错误（大小写敏感）
• 启动类有没有 @SpringBootApplication 注解

Q3：IDE 报错“Cannot resolve symbol”

这是因为依赖没有正确加载。解决办法：

• 在 IntelliJ 中点击右侧的 Maven → Reload Project
• 或者等待一段时间让 Maven 下载完所有依赖

---

学习建议：下一步学什么？

恭喜你完成了第一个 Spring Boot 项目！接下来你可以继续学习：

第一阶段（初级）：

• 学习 RESTful API 设计规范
• 接触数据库操作（Spring Data JPA / MyBatis）
• 了解前后端分离架构（如 Vue.js + Spring Boot）

第二阶段（中级）：

• 使用 Thymeleaf 模板引擎渲染 HTML 页面
• 掌握日志记录（Logback、SLF4J）
• 接入 Redis、RabbitMQ 等中间件

第三阶段（高级）：

• 掌握 Spring Security 做权限控制
• 微服务架构（Spring Cloud）
• 使用 Docker 部署应用

---

总结

通过这篇《Spring Boot入门教程：60分钟快速上手》，你现在应该已经掌握了：

• 如何创建一个 Spring Boot 项目
• Spring Boot 的基本结构与核心组件
• 如何写一个简单的 API 接口
• 新手常见问题的排查方法

坚持多练，多查文档，你一定可以成为一位优秀的后端开发者！

Happy Coding 🧑‍💻