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

RAG小工匠

2025-06-28 18:33

阅读 317

一、开篇：Spring Boot是什么，为什么要学？

你有没有听说过“写一个网站要好几个月”？
如果你是一个刚刚接触后端开发的新手，你可能会觉得Java后端开发又复杂又难懂。确实，在过去，搭建一个完整的Web应用需要配置各种框架、处理各种依赖、还要手动整合数据库……整个过程非常繁琐。

而Spring Boot的出现，就是为了简化这一切。它不是一门新语言，也不是一个新的框架，而是Spring Framework的增强版，它的核心目的是：

让开发者更容易、更快地上手Spring应用的开发

那Spring Boot到底能干什么？

简单来说，你可以用它：

快速搭建Web项目（比如博客系统、电商后台）
开发RESTful API接口（供前端或APP调用）
整合数据库做数据持久化
做企业级应用原型
搭建微服务架构的基础组件

而且，Spring Boot内置了很多“启动器”（Starter），比如你要做Web开发，只需要引入一个包即可，无需手动配置Tomcat、Servlet等底层东西。真正做到“开箱即用”。

二、环境准备：安装和配置开发工具

在开始编码之前，我们先来准备好开发环境。以下是我们需要的工具：

1. Java 环境

Spring Boot 是基于 Java 的，所以你需要先安装 Java 运行环境。

安装方式：

去官网下载安装包：Oracle JDK 或使用 OpenJDK。

安装完成后，打开终端或命令行，输入：

java -version

如果看到输出类似：

openjdk version "11.0.2" 2019-01-15

说明安装成功 ✅

2. IDE（集成开发环境）

初学者推荐使用 IntelliJ IDEA Community 版本（免费）。

👉 下载地址：JetBrains IntelliJ IDEA

安装完成后，打开IDEA → Create New Project → 选择 “Spring Initializr”

如果没有这个选项，请确保你安装了 Spring 插件（Settings → Plugins → 搜索 Spring）

3. Maven（项目构建工具）

Spring Boot 默认使用 Maven 构建项目，你不需要单独安装它，因为IDEA已经自带了。

三、核心概念讲解：通俗易懂地理解关键术语

学习任何新技术，第一步总是理解它的“语言”。我们来看看Spring Boot中最常见的几个关键词：

1. Spring Boot Starter

这是什么？

Starter 就是一组已经配置好的依赖库打包成的“一键安装包”。

举个例子：

如果你想开发一个Web应用，那就用 spring-boot-starter-web，这个包包含了Web相关的一切配置。
如果你想连接数据库，就加 spring-boot-starter-data-jpa，里面已经整合了Hibernate和JPA规范。
所有的Starter都以 spring-boot-starter-xxx 命名。

你不需要自己一个一个去添加依赖，也不需要一个个配配置文件，Spring Boot已经帮你做好了！

2. 自动配置（Auto Configuration）

以前我们要用Spring，必须写很多配置XML文件或者注解来告诉程序该怎么运行。现在呢？Spring Boot会自动识别你的环境，并做出合适的配置。

举个栗子🌰：

你在pom.xml中添加了web starter，那Spring Boot就知道你要做一个Web应用，就会自动：

启动内嵌Tomcat
加载默认端口（8080）
支持静态资源（如HTML、CSS、JS）
支持Spring MVC

根本不用你自己写一行配置，这就是自动化的力量！💪

3. main方法和@SpringBootApplication

每个Spring Boot项目都有一个入口类，长这样：

@SpringBootApplication
public class HelloApplication {

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

}

这几句代码到底做了什么？

@SpringBootApplication 是一个复合注解，包含了：
- @ComponentScan：扫描所有Bean
- @EnableAutoConfiguration：启用自动配置
main() 方法是项目的启动入口，调用了 SpringApplication.run(...) 来启动应用

简单说：这段代码就是告诉你电脑：“嘿，这里是我的Spring Boot程序，从这里开始运行！”

4. Controller：处理请求的角色

在Spring Boot中，处理HTTP请求的类叫做Controller。

比如：

@RestController
public class HelloController {

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

}

当你访问 /hello 这个地址的时候，浏览器就能看到返回的字符串。

@RestController = @Controller + @ResponseBody，表示这个类直接返回内容给浏览器
@GetMapping 表示这是一个GET请求对应的路径

5. 项目结构简述

新建一个Spring Boot项目时，默认会有这样的目录结构：

src/
├── main/
│   ├── java/
│   │   └── com.example.demo/
│   │       ├── DemoApplication.java     ← 主程序
│   │       └── controller/              ← 存放Controller类
│   │            HelloController.java
│   │
│   ├── resources/
│        ├── application.properties      ← 配置文件
│        ├── static/                     ← 静态资源（HTML/CSS/JS）
│        └── templates/                  ← 页面模板（Thymeleaf）

这个结构很清晰，有助于后期维护。

四、实战项目：构建一个最简单的Spring Boot Web应用

我们来一步步完成一个小项目：一个提供“问候语”的Web页面。

第一步：创建Spring Boot项目

打开 IntelliJ IDEA：

File → New → Project
选择 Spring Initializr → Next
设置 Group 和 Artifact（例如：group: com.example / artifact: hello-app）
添加依赖项：
- Spring Web
点击Finish

等待加载完成，你会看到项目结构生成完毕 ✅

第二步：编写第一个Controller

在 com.example.helloapp.controller 包下，新建一个类：HelloController.java

package com.example.helloapp.controller;

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

@RestController
public class HelloController {

    @GetMapping("/hello")
    public String greet() {
        return "Hello, welcome to Spring Boot world!";
    }

}

这段代码定义了一个接口 /hello，当访问它时，返回一段问候语。

第三步：运行主程序

找到主程序类 HelloAppApplication.java，右键点击 Run，或者点击绿色的运行按钮 ▶️

控制台应该会输出：

Started HelloAppApplication in 3.2 seconds (JVM running for 4.1)

说明服务已经启动成功！

第四步：访问网页

打开浏览器，访问：

http://localhost:8080/hello

你应该会看到页面显示：

Hello, welcome to Spring Boot world!

恭喜你，完成了第一个Spring Boot项目！🎉

第五步：添加更多功能

我们可以再添加一个返回JSON的接口，比如天气信息：

@GetMapping("/weather")
public Map<String, Object> getWeather() {
    Map<String, Object> data = new HashMap<>();
    data.put("city", "Beijing");
    data.put("temperature", 25);
    data.put("condition", "Sunny");
    return data;
}

缓存策略对比-1

访问：http://localhost:8080/weather

你应该能看到一个漂亮的JSON格式的结果 👌

五、常见问题解答：新手常踩的坑

以下是新手在学习Spring Boot过程中常遇到的一些问题，以及解决方案👇

❓Q1：为什么启动项目时提示“No JVM installation found”？

💡 原因：Java环境未正确安装或未被系统识别
✅ 解决办法：

确保已安装JDK（不是JRE）
在系统环境变量中设置 JAVA_HOME
检查IDE是否选择了正确的SDK（File → Project Structure → SDKs）

❓Q2：访问页面提示404怎么办？

💡 可能原因：

路径拼写错误（比如写成了 /helo）
Controller类没有添加 @RestController
方法没有加上 @GetMapping 或 @PostMapping
控制器类不在主类的子包中（Spring Boot只扫描主类及其子包中的组件）

✅ 建议检查点：

URL路径是否正确
注解是否完整
类是否被Spring管理（是否被组件扫描到）

❓Q3：Maven报错：无法下载依赖怎么办？

💡 可能原因：

网络不通或代理设置不对
Maven仓库配置错误

✅ 解决办法：

检查网络连接
修改 settings.xml 文件，添加国内镜像源（如阿里云）：

<mirrors>
    <mirror>
        <id>nexus-aliyun</id>
        <mirrorOf>*</mirrorOf>
        <url>https://maven.aliyun.com/repository/public</url>
    </mirror>
</mirrors>

❓Q4：端口被占用怎么办？

💡 报错提示可能是：

Address already in use

✅ 解决方法：

找出哪个进程占用了8080端口（Windows：任务管理器；Mac/Linux：lsof -i :8080）
终止该进程
或者修改Spring Boot的默认端口：

在 application.properties 中添加：

server.port=8081

六、学习建议：下一步该学什么？

恭喜你完成了本次Spring Boot的入门教程！你现在可以写出一个基本的Web接口了！

接下来可以尝试以下方向继续深入：

✅ 建议1：学习Spring Boot与数据库交互

学习 JPA（Java Persistence API）操作数据库
使用 Spring Data JPA 简化CRUD操作
实战案例：用户注册登录系统

✅ 建议2：认识RESTful风格接口设计

什么是 REST？
GET vs POST vs PUT vs DELETE 的区别
如何设计优雅的API路径

✅ 建议3：了解Spring Boot的配置体系

application.properties 和 application.yml 的区别
多环境配置（dev、test、prod）
使用 @Value 和 @ConfigurationProperties 注入配置值

✅ 建议4：前后端分离与接口对接实践

用Spring Boot提供API，用Vue.js或React做前端
实践AJAX请求获取数据
学习跨域（CORS）问题的解决方法

✅ 建议5：阅读官方文档与优秀开源项目

官方文档：Spring.io
GitHub上找一些开源项目（搜索关键字：spring boot example）
参考别人如何组织项目结构、分层设计、日志管理等

七、总结：60分钟你收获了什么？

在这次教程中，我们一起做了以下几件事：

理解了什么是Spring Boot，它解决了哪些问题
搭建了本地开发环境
了解了Spring Boot的核心概念（Starter、自动配置、Controller等）
动手完成了一个简单的Web项目
遇到了问题并找到了解决办法
规划了接下来的学习方向

记住一句话：

编程不是学出来的，是写出来的 💻

希望你能继续敲代码，不断实践、不断改进，逐步成为一名优秀的Java开发者！

如需进阶学习资料或实战项目模版，欢迎留言交流，我会为你准备更详细的路线图 😊

标签:技术分享Python代码人生运营

最热最新

暂无评论

为你推荐

暂无相关推荐