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

翩翩蝶
2025-06-21 14:34
阅读 252

开篇:Spring Boot是什么?

开篇: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 17JDK 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 没有正确加载依赖。

解决办法:

  1. 右键项目 → Maven → Reload Project
  2. 如果仍不行,删除 .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

最热最新
暂无评论
匿名用户Lv.1
0
影响力
0
文章
0
粉丝