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

大家好，我是你们的技术团队培训负责人。过去几年里，我带过上百名应届生从零开始学习后端开发。每次看到新同学面对Spring Boot一脸迷茫的样子，我就想起自己当初学的时候——文档看不懂、概念绕来绕去、环境搭半天还跑不起来……那种挫败感真的很难受。

所以今天，我特意写了这篇《Spring Boot入门教程》，目标是让你在60分钟内写出第一个能跑起来的Spring Boot程序。无论你有没有Java基础（当然有更好），只要你愿意动手敲代码，就能跟着走完！

为什么选Spring Boot？
它是目前企业级Java后端开发的事实标准。用它写接口、连数据库、做微服务都特别方便。而且，它能自动处理很多繁琐配置，让你专注业务逻辑。

---

一、环境准备：5分钟搞定开发工具

你需要安装什么？

工具	作用	推荐版本
JDK	Java运行环境	JDK 17（LTS长期支持版）
IDE	写代码的编辑器	IntelliJ IDEA Community（免费）
Maven	项目依赖管理工具	内置在IDEA中，无需单独安装

💡 开发心得：很多新手卡在环境搭建这一步。别担心！只要按顺序装好JDK和IDEA，其他都交给IDEA自动处理。

安装步骤（超简版）

1. 下载并安装JDK 17

   • 访问 Oracle官网 或使用开源版 OpenJDK
   • 安装后打开终端，输入 java -version，看到类似 openjdk version "17.0.10" 就成功了

2. 下载并安装IntelliJ IDEA Community

   • 官网：https://www.jetbrains.com/idea/download/
   • 安装时全部默认选项即可

3. 验证IDEA是否识别JDK

   • 打开IDEA → File → Project Structure → Project Settings → Project
   • 确保 Project SDK 显示的是JDK 17

✅ 避坑指南：不要用Eclipse！对新手不友好。IDEA有智能提示、一键生成代码，能省下大量调试时间。

---

二、核心概念：用“餐馆”比喻理解Spring Boot

我当初学的时候，最头疼的就是“Spring”、“Boot”、“Bean”这些词。其实它们没那么玄乎：

• Spring Boot = 自动化厨房

  • 传统Spring就像手动炒菜：你要自己洗锅、点火、控温……
  • Spring Boot则是智能厨房：你只说“我要一份宫保鸡丁”，它自动完成所有步骤

• Controller = 点菜单

  • 用户（前端）说“我要数据”，Controller接收请求并返回结果

• Application = 整个餐馆的启动开关

  • 一个带 @SpringBootApplication 注解的主类，启动后整个服务就跑起来了

• 依赖（Dependencies）= 厨房里的食材和调料

  • 比如你要做Web服务，就加 spring-boot-starter-web 这个“调料包”

🌟 关键思想：Spring Boot的核心是“约定优于配置”。你不用写一堆XML，它按默认规则自动装配。

---

三、实战项目：写一个返回“Hello World”的API

现在，我们动手做一个最简单的Web服务。完成后，你可以在浏览器里看到 "Hello, Spring Boot!"。

第1步：创建项目（2分钟）

1. 打开IDEA → New Project
2. 左侧选 Spring Initializr
3. 填写：
   • Project SDK: JDK 17
   • Language: Java
   • Type: Maven
4. 点击 Next
5. 填写：
   • Group: com.example
   • Artifact: demo
6. 点击 Next
7. 关键一步：在依赖列表中勾选 Spring Web
8. 点击 Finish

💡 此时IDEA会自动生成项目结构，包括 pom.xml（Maven配置文件）和主启动类。

第2步：写一个Controller（3分钟）

在 src/main/java/com/example/demo 目录下，新建一个Java文件 HelloController.java：

package com.example.demo;

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：告诉Spring这是一个处理Web请求的类
• @GetMapping("/hello")：当用户访问 /hello 路径时，执行下面的方法
• 方法直接返回字符串，Spring Boot会自动把它变成HTTP响应

第3步：启动项目（1分钟）

找到项目中的 DemoApplication.java（名字可能略有不同），右键 → Run 'DemoApplication.main()'

你会看到控制台输出大量日志，最后几行类似：

Tomcat started on port(s): 8080 (http)
Started DemoApplication in 2.345 seconds

✅ 成功！你的服务已运行在 http://localhost:8080

第4步：测试API（1分钟）

打开浏览器，访问：
http://localhost:8080/hello

你应该看到页面显示：
Hello, Spring Boot!

🎉 恭喜！你已经完成了第一个Spring Boot应用。全程不到10分钟。

---

四、进阶一点：返回JSON数据（给前端用）

现实中，后端很少直接返回纯文本，而是返回结构化数据（通常是JSON），供前端解析。

修改代码

1. 先创建一个数据类 Message.java：

package com.example.demo;

public class Message {
    private String content;

    public Message(String content) {
        this.content = content;
    }

    // 必须有getter方法，Spring才能转成JSON
    public String getContent() {
        return content;
    }
}

2. 修改 HelloController.java：

@GetMapping("/api/hello")
public Message getHelloMessage() {
    return new Message("Hello from Spring Boot API!");
}

3. 重启应用（IDEA里点红色方块停止，再点绿色三角启动）

4. 浏览器访问 http://localhost:8080/api/hello

你会看到：

{
  "content": "Hello from Spring Boot API!"
}

💡 开发心得：前端拿到这个JSON后，可以用JavaScript轻松读取 content 字段并显示在页面上。这就是前后端协作的基本模式！

---

五、常见问题解答（新手必看）

Q1：启动时报错 “Address already in use”

原因：8080端口被其他程序占用了（比如另一个Spring Boot项目还在运行）
解决：

• 方法1：关闭占用端口的程序
• 方法2：修改端口。在 src/main/resources/application.properties 中添加：

  server.port=8081
  

Q2：浏览器显示404

检查点：

• 路径是否拼写正确？比如 /hello 不是 /Hello
• Controller类是否在主启动类的子包下？
  （Spring Boot默认只扫描主类所在包及其子包）

Q3：修改代码后没生效？

原因：Spring Boot默认不会热加载
解决：

• 手动重启（适合初学）
• 或添加 spring-boot-devtools 依赖实现自动重启（后续可学）

Q4：看不懂控制台日志？

建议：初期忽略大部分日志，只关注最后几行是否有 Started ... in X seconds。出错时再回看红色错误信息。

---

六、学习建议与下一步路线

你已经迈出了最重要的一步！接下来，我建议按这个路径深入：

短期目标（1周内）

主题	学习重点	推荐实践
请求参数	@RequestParam, @PathVariable	写一个 /user/{id} 接口
返回对象	创建POJO类，自动转JSON	模拟返回用户信息
配置文件	application.properties	修改端口、设置自定义属性

中期目标（1个月内）

• 连接数据库（H2或MySQL）
• 使用MyBatis或JPA操作数据
• 写CRUD接口（增删改查）

长期心法

不要死记代码，要理解“谁调用了谁”。
比如：浏览器 → 发送请求 → Spring Boot路由到Controller → 返回数据 → 浏览器显示
把这个链条搞清楚，你就掌握了Web开发的本质。

---

结语

60分钟很短，但足够点燃你对后端开发的兴趣。我带过的很多优秀工程师，都是从这样一个小小的“Hello World”开始的。

记住：每个大神都曾是小白。你现在遇到的困惑，我当初都经历过。关键不是一次就懂，而是不断动手、不断试错。

下次见面时，希望你能自豪地说：“我已经用Spring Boot写了三个接口了！”

加油，未来的后端之星！🚀

附：常用命令速查表

操作	命令/方式
启动项目	在IDEA中运行主类的 main() 方法
停止项目	点击控制台旁边的红色方块
添加依赖	在 pom.xml 的 <dependencies> 中加入新 <dependency>
查看端口	控制台搜索 Tomcat started on port(s)
访问本地服务	http://localhost:8080/你的路径