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

你可能听说过“Java后端开发”,而Spring Boot就是帮助我们用Java开发网页后端(比如网站后台、APP接口)的工具。你可以把它理解成一个“自动组装的工具箱”。
以前写一个Java后端项目,需要做很多配置和安装很多东西。而Spring Boot帮我们把这些都简化了,就像给你的代码加了个“一键启动”按钮。
简单来说:
- Spring Boot = 简化版的Java Web开发框架
- 用途:快速搭建Web服务、REST API、微服务等
- 特点:内置服务器、自动配置、开箱即用
第一步:环境准备(别担心,一步步来)

在开始之前,你需要先准备好开发环境。下面这些是必须安装的软件,跟着步骤来,很快就能搞定。
1. 安装 Java JDK
Java开发需要JDK(Java Development Kit)。推荐使用 JDK 17 或 JDK 21。
Windows/Mac用户:
前往官网下载并安装 https://www.oracle.com/java/technologies/downloads/
安装完成后,打开终端(或命令行)输入以下命令检查是否安装成功:
java -version
你应该会看到类似这样的输出:
openjdk version "17.0.8" 2023-07-18
2. 安装 IDE(集成开发环境)
推荐使用 IntelliJ IDEA Community Edition(免费),它是专门为Java开发设计的强大编辑器。
👉 下载地址:https://www.jetbrains.com/idea/download/
安装好之后,打开它,等待初始化完成即可。
3. 创建第一个 Spring Boot 项目(超简单)
访问官方网站生成模板:
👉 https://start.spring.io
按照下图设置:
- Project: Maven
- Language: Java
- Spring Boot Version: 3.x(比如 3.1)
- Group: com.example
- Artifact: demo
- Name: demo
- Packaging: Jar
- Java Version: 17 或 21
点击下方的 Generate 按钮,下载 zip 文件解压后就可以用 IntelliJ 打开了。
核心概念讲解(别怕术语,我来解释)
学任何技术,都要了解它的基本概念。下面是几个关键术语,我会用最通俗的语言来解释。
什么是“Maven”?
可以理解为依赖管理工具,也就是帮你自动下载代码中用到的“第三方零件”。比如你要连接数据库,只需要告诉Maven你要用哪个库,它就自动去网上下载下来。
<!-- 示例:引入Web功能 -->
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-web</artifactId>
</dependency>
什么是“Controller”?
这是控制器的意思。你可以把它理解成“处理浏览器请求的大脑”。
例如:当用户访问 /hello 这个网址时,由某个 Controller 来响应请求。
示例代码:
@RestController
public class HelloController {
@GetMapping("/hello")
public String sayHello() {
return "你好,欢迎来到 Spring Boot 世界!";
}
}
运行程序后,访问 http://localhost:8080/hello 就可以看到这句话!
什么是“Application 类”?
每个 Spring Boot 项目都会有一个带有 @SpringBootApplication 注解的主类,它是程序的入口。
示例代码如下:
@SpringBootApplication
public class DemoApplication {
public static void main(String[] args) {
SpringApplication.run(DemoApplication.class, args);
}
}
你可以把它看作是“启动按钮”。双击运行这个类,Spring Boot 的服务器就会开始工作。
实战项目:做个简单的 API 接口
下面我们动手做一个小项目:创建一个能返回“Hello World”的 REST 接口。
步骤1:添加 Web 支持
如果你刚才选择的项目类型是 Web,则已经包含了相关依赖。否则可以在 pom.xml 中添加如下内容:
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-web</artifactId>
</dependency>
保存文件后,Maven 会自动下载所需资源。
步骤2:创建一个 Controller
右键 src/main/java/com.example.demo 目录 → New → Java Class → 输入类名 HelloController
然后写入如下代码:
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 helloWorld() {
return "Hello World!";
}
}
步骤3:运行项目
找到并运行 DemoApplication.java 中的 main 方法。控制台应该会出现如下信息:
Tomcat started on port(s): 8080 (http)
表示服务器已经在本地启动。
步骤4:测试接口
打开浏览器,访问:
http://localhost:8080/hello
你会看到页面显示:
Hello World!
恭喜你,你的第一个 Spring Boot 接口已经完成了!
新手常见问题解答
以下是一些新手常遇到的问题及解决方法:
✅ 问:启动时报错:“Could not find the main class”
可能是你没有正确设置主类(带有 @SpringBootApplication 的类)。
解决办法:
检查主类有没有 public static void main() 方法,并确保该类有 @SpringBootApplication 注解。
✅ 问:访问不了 http://localhost:8080/hello
请确认项目已正常启动,控制台没有报错。如果没问题但还是访问不到,请关闭防火墙或杀毒软件。
✅ 问:IDEA 报错:Cannot resolve symbol ‘SpringBootApplication’
这通常是因为 Maven 没有正确加载依赖。
解决办法:
- 右键项目 → Maven → Reload Project
- 如果仍不行,删除
.m2/repository/org/springframework/boot文件夹后再 reload
✅ 问:我想用别的端口号怎么办?
修改 application.properties 文件:
server.port=8090
重启项目后,你的服务就运行在 8090 端口了。
学习建议(下一步怎么走)
学会了基础,只是刚进门。接下来你可以尝试以下几个方向继续学习:
1. 学习数据库操作(JPA / MyBatis)
试试连接 MySQL,完成增删改查操作。
推荐知识点:
@Entity实体类JpaRepository接口- 使用 Postman 测试接口
2. 接口文档工具 Swagger UI
用来自动生成 API 文档,方便前后端协作。
3. 异常处理 & 日志打印
让系统更健壮、更容易排查问题。
4. 配置管理(application.properties)
掌握如何读取配置信息,如数据库账号密码、环境参数等。
5. 微服务初体验(进阶)
使用 Spring Cloud 构建多个微服务,模拟真实的企业级架构。
总结
本篇教程带你从零开始快速上手 Spring Boot,完成了第一个 Web 接口。整个过程无需复杂的配置,一切都很自然地就跑起来了。
记住一句话:“Spring Boot 是让你少写配置、专注业务的工具。”
只要持续练习,相信不久之后,你也能做出属于自己的网站后台系统!
💡 练习建议:
- 自己写一个
/greet?name=xxx接口,根据名字返回“你好,XXX” - 加入日志输出:使用
System.out.println()或Logger输出调试信息 - 学会查看控制台日志,理解每次请求发生了什么
如有疑问,欢迎留言提问,祝你编程之路顺利!

评论 0