SpringBoot快速上手

SizeTheMoment2025-05-22 9:55

idea版本:

社区版：2021.1--2022.1.4

专业版:无要求

如果个⼈电脑安装的idea不在这个范围, 需要卸载重新安装. Idea 卸载参考: https://blog.csdn.net/qq_19072921/article/details/126408402 (⼀定要删除注册表)

Maven:

什么是Maven

官方对于Maven的描述:

Apache Maven is a software project management and comprehension tool. Based on the concept of a project object model (POM), Maven can manage a project's build, reporting and documentation from a central piece of information.

翻译过来就是:

  • Apache Maven 是一种软件项目管理和理解工具。基于项目对象模型 （POM） 的概念，Maven 可以从一个中心信息管理项目的构建、报告和文档
  • 总结就是，Maven是一个项目管理工具，提高我们的开发效率，减少我们的开发Bug

Maven有很多功能，但是本篇文章只体现两个方面:项目构建，管理依赖

创建⼀个Maven项目

IDEA本身已经集成了Maven, 我们可以直接使用, 无需安装

项目结构:

Maven命令

clean命令

Jar命令(打包)

  • 打包就是把所有的class文件, 全部放在⼀起, 打成jar包或者war包
  • jar包就是把开发⼈员已经写好的⼀些代码进行打包. 打好的jar包就可以引⼊到其他项目中, 也可以直接使⽤这些jar包中的类和属性，另外也可以打成可执行jar包, 这样的包就可以通过java -jar命令来执行
  • war包可以理解为是⼀个web项目，里面是项目的所有东西，通常用于网站

依赖管理

maven是一个项目管理工具，通过pom.xml文件的配置获取jar包，而不用手动去添加jar包，获取jar包，其实就是依赖

pom.xml是Maven的配置文件，用以描述项目的各种信息

依赖配置

  • 依赖：指当前项目运行所需要的jar包，之前文章中学习JDBC时，我们需要手动下载mysql-connector-java的包，并且添加到项目中
  • 如果使用Maven, 我们只需要在pom.xml中引入mysql-connector-java的依赖就可以了
XML 复制代码 
<dependencies>
 <!--⾥⾯放置项⽬的依赖坐标, 可为多个 -->
</dependencies>
  • 在pom文件标签内, 添加依赖坐标
XML 复制代码 
<!-- https://mvnrepository.com/artifact/com.mysql/mysql-connector-j -->
<dependency>
    <groupId>com.mysql</groupId>
    <artifactId>mysql-connector-j</artifactId>
    <version>8.2.0</version>
</dependency>
  • 点击刷新按钮，引入新加入的依赖jar包

后续有添加新的jar包, 或者修改jar包版本, 都需要通过该⽅式在项⽬中添加依赖.

刷新完之后, 就可以在项⽬中看到新加⼊的jar包

依赖传递

  • 早期我们没有使用maven时, 向项目中添加依赖的jar包，需要把所有的jar包都复制到项目工程下.
  • 比如A依赖B, B依赖C, 那么 A项目引入B的同时, 也需要引入C, 如果我们手动管理这个依赖, 这个过程就会比较麻烦, 我们需要知道每个库都依赖哪些库, 以及这些依赖之间的版本是如何关联的

⽐如我们要吃⽕锅, 需要有锅, 有调料, 有⻝材, 以及确认什么样的锅, 什么样的⻝材. ⽐如去医院看病, 需要带上以往的病历, 检查结果, 处⽅等, 并且要确认带的资料是正确的, 如果⽇期错 了, 或者患者错了, 带少了, 就需要回去重新拿.

但使⽤maven的话, 就可以避免管理所需依赖的关系。我们只需要在pom⽂件中, 定义直接依赖就可以 了, 由于maven的依赖具有传递性，所以会⾃动把所依赖的其他jar包也⼀起导⼊

比如吃火锅, 现在我们可以点⼀个海底捞外卖, 直接就把所有⻝材都送过来了, 包括什么锅, 配什么菜

⽐如去医院看病, 借助"互联网", 实现了信息共享, 只需要带上身份证, 以往的病历和检查结果就都可以看到了.

·如上图, 项目A通过Maven 引入Jar A 时, 会⾃动引⼊ Jar B 和Jar C.

Jar A 和项⽬B就是项⽬A的直接依赖.

Jar B, Jar C是间接依赖.

直接依赖：在当前项⽬中通过依赖配置建⽴的依赖关系

间接依赖：被依赖的资源如果依赖其他资源，当前项⽬间接依赖其他资源

依赖排除

当前阶段我们需要依赖的库并不多, 但随着项⽬的越来越复杂, 库之间的依赖关系也会变得越来越复杂

如上图中, 如果项⽬A不需要Jar B,也可以通过排除依赖的⽅式来实现.

排除依赖: 指主动断开依赖的资源。（被排除的资源⽆需指定版本）

⽐如, 我下了⼀个快递单⼦, 默认会有⼀个服务, 就是快递⼩哥会上⻔取件, 但是我刚好要出⻔, ⽽且顺 路经过站点, 也可以选择⾃⼰送过去

XML 复制代码 
<dependency>
    <groupId>org.springframework</groupId>
    <artifactId>spring-core</artifactId>
    <version>6.0.6</version>
    <!--排除依赖-->
    <exclusions>
        <exclusion>
            <artifactId>spring-jcl</artifactId>
            <groupId>org.springframework</groupId>
        </exclusion>
    </exclusions>
</dependency>

maven还有⼀些功能是依赖调解, 可选依赖等

依赖调解:

当项⽬中的依赖存在依赖冲突时, 例如 存在这样的依赖：

A->B->C->X(1.0)

A->D->X(2.0)

Maven会采⽤最短路径优先的原则去选择依赖，这⾥2的依赖路径更短，所以会选择X(2.0), 当然我们 也可以选择指定某个依赖的版本

当然也可以指定X的版本

Maven Help插件

当项⽬⽐较复杂时, 我们就会有Jar包冲突的问题, 这时候就需要去解决依赖冲突. 解决冲突之前, 需要先 找到冲突, 我们可以使⽤Maven Help插件来观察包和包之间的依赖关系

安装插件: File -> Settings ->Plugins -> 搜索'Maven Help' -> 找到对应插件, 点击Install 安装即可, 安装 后需要重启下idea, 才能⽣效

  • 安装之后, 打开pom⽂件, 可以看到Jar包之间的依赖关系

也可以右键排除掉⼀些依赖

Maven 仓库

我们通过短短几行代码, 就把依赖jar包放在了项目里, 具体是如何做的呢?

XML 复制代码 
<dependency>
     <groupId>mysql</groupId>
     <artifactId>mysql-connector-java</artifactId>
     <version>8.0.30</version>
</dependency>

这个代码, 我们称之为 "坐标", 也就是唯⼀的.

在Maven中, 根据 groupId、artifactId、version 的配置, 来唯⼀识别⼀个 jar 包, 缺⼀不可.

当我们在pom⽂件中配置完依赖之后, 点击刷新, Maven会根据坐标的配置, 去仓库⾥寻找Jar包, 并把他 下载下来, 添加到项⽬中. 这个Jar包下载的地⽅就称为仓库.

仓库：⽤于存储资源，管理各种jar包

Maven仓库的本质就是⼀个⽬录(⽂件夹)，这个⽬录被⽤来存储开发中所有依赖(jar包, 插件等)

Maven仓库分为两⼤类: 本地仓库和远程仓库. 其中远程仓库⼜分为中央仓库, 私服 和其他公共库

本地仓库

本地仓库: ⾃⼰计算机上的⼀个⽬录(⽤来存储jar包)

当项⽬中引⼊对应依赖jar包后，⾸先会查找本地仓库中是否有对应的jar包

  • 如果有，则在项⽬直接引⽤
  • 如果没有，则去中央仓库中下载对应的jar包到本地仓库

本地仓库地址可以通过Maven配置查看: File -> Settings

查看该仓库⽬录, 可以看到该⽬录下有很多的jar(最开始是空的, 随着Maven的使⽤, 该仓库下⽂件会越 来越多)

中央仓库

中央仓库: maven 软件中内置⼀个远程仓库地址，就是中央仓库，服务于整个互联⽹. 由 Maven 团队 维护，全球唯⼀.

仓库地址：https://repo1.maven.org/maven2/

可以通过https://mvnrepository.com 这个⽹站来查询并下载 我们可以把⾃⼰写好的Jar包上传到中央仓库(具备⼀定的要求), 也可以从中央仓库下载Jar包

查找Jar的坐标

  1. 访问 https://mvnrepository.com/
  2. 进⾏查找, ⽐如mysql

https://mvnrepository.com/

选择要添加的Jar包版本

查看Jar包对应坐标

私有服务器, 也称为私服

  • 私服: ⼀般由公司团队搭建的私有仓库.
  • 私服属于某个公司,或者某个部⻔, 往往需要⼀定权限.
  • 有了私服之后, Maven依赖下载的顺序⼜发⽣了变化

当Maven需要下载资源的时候

  1. 先从本地仓库获取, 本地仓库存在, 则直接返回
  2. 如果本地仓库没有, 就从私服请求, 私服存在该资源, 就直接返回
  3. 如果私服上不存在该资源，则从中央仓库下载, 中央仓库不存在, 就报错了...
  4. 如果中央仓库中存在, 就先缓存在私服上之后，再缓存到本地仓库⾥, 再为Maven的下载请求提供服务

私服是很多⼈在使⽤的, 所以只需要第⼀个使⽤者下载⼀次就可以了

配置当前项⽬setting File -> Settings

查看配置⽂件的地址, 如上图所⽰, Maven配置⽂件地址为: D:\Maven\.m2\settings.xml

不同电脑设置的Maven路径不同

settings和repository 可以修改设置为其他路径, 两个路径不要有中⽂

配置国内源

Maven 仓库默认在国外https://mvnrepository.com/， 国内使⽤时会⽐较慢，我们可以更换为阿⾥云的仓库

也可以选择别的仓库, 参考: Maven 镜像地址⼤全

打开settings.xml, 在 mirrors 节点上，添加内容如下：

XML 复制代码 
 <mirror>
     <id>aliyunmaven</id>
     <mirrorOf>central</mirrorOf>
     <name>阿⾥云公共仓库</name>
     <url>http://maven.aliyun.com/nexus/content/groups/public/</url>
 </mirror>

如果上述地址不存在settings文件， 则直接复制课件中提供的文件粘贴过去即可

设置新项⽬的setting

上述配置的内容, 只对当前项⽬⽣效, 为了让后续新建的项⽬也⽣效, 需要重新设置⼀下新项⽬的 Settings

当前项⽬和新项⽬共⽤⼀个setttings⽂件即可, 所以新项⽬的设置, 只需要确认⼀下settings⽂件的路径即可

第⼀个SpringBoot程序

Spring Boot介绍

在学习SpringBoot之前, 我们先来认识⼀下Spring

我们看下Spring官⽅(https://spring.io/)的介绍

可以看到, Spring让Java程序更加快速, 简单和安全. Spring对于速度、简单性和⽣产⼒的关注使其成为 世界上最流⾏的Java框架。

Spring官⽅提供了很多开源的项⽬, 覆盖范围从Web开发到⼤数据, Spring发展到了今天, 已经形成了自己的⽣态圈. 我们在开发时, 也倾向于使⽤Spring官⽅提供的技术, 来解决对应的问题.

这些项⽬都是基于Spring Framework来进⾏开发的, 但是Spring Framework存在配置多, ⼊⻔难的问 题, Spring也意识到了这个问题, 为了简化开发者的使⽤, 从而创造性的推出了SpringBoot

接下来我们看下什么是Spring Boot. Spring Boot 的诞⽣是为了简化 Spring 程序开发的. Spring Boot 翻译⼀下就是 Spring 脚⼿架，什么是脚⼿架呢？如下图所⽰：

盖房⼦的这个架⼦就是脚⼿架，脚⼿架的作⽤是砌筑砖墙，浇筑混凝⼟、⽅便墙⾯抹灰，装饰和粉刷 的，简单来说，就是使⽤脚⼿架可以更快速的盖房⼦

⽽ Spring Boot 就是 Spring 框架的脚⼿架，它是为了快速开发 Spring 框架⽽诞⽣的. 以前铺路是这样的：

改造之后的效率是这样的：

或者是这样的：

可以看到，每次技术的诞⽣和改进相⽐于之前的效率会有⼀个质的提升，⽽ Spring Boot 相⽐于 Spring 也是如此.

Spring Boot 项⽬创建

使⽤ Idea 创建 因为我们⽤的 Idea 社区版（其他版本也同样适⽤），所以先要安装 Spring Boot Helper插件才能创建 Spring Boot 项⽬

安装Spring Boot Help插件

使⽤专业版Idea不需要安装插件, Idea已经集成了

查找插件并下载

点击 Plugin homepage , 进入网页下载插件

  • 此处不要直接点击 Install
  • 直接点击Install, 安装的是收费版(⼟豪请随意)

插件地址：https://plugins.jetbrains.com/plugin/18622-spring-boot-helper/versions

插件对Idea版本有要求, Idea版本需要在2021.1 -2022.1.4范围内, 不在这个范围内需要重新卸载安装 卸载要删除注册表的内容

安装插件

按下图序号操作, 逐步安装插件

选择刚才下载的插件, 安装, 重启Idea即可

此时查看已安装插件

安装好之后，它的名字就变成了 Spring Initializr and Assistant，如下图所示：

不要点击 update!!!

创建SpringBoot项目

接下来我们来创建 Spring Boot 项⽬： File -> New ->Project

上图说明

  • SpringBoot版本 , 选择任意3.X的, 这个版本会随着SpringBoot的升级⽽发⽣变化, 不固定
  • 3.X版本使⽤的是jdk17, 3.X以下使⽤的是JDK8
  • 打勾表⽰创建项⽬之初, 就引⼊的第三⽅依赖(框架, 插件, 组件等...后⾯再细讲)

点击 Create 就完成 Spring Boot 的项⽬创建了。

  • 注意事项
  • 第⼀次打开 Spring Boot 项⽬需要加载很久，因为当前 Spring Boot 框架并没有在⾃⼰的本地仓库
  • 为了加速 Spring Boot 项⽬的下载，在打开项目之前，请先确认自己的 Maven 已经配置为国内源

⽹⻚版创建（了解）

不使⽤ Idea 也可以创建 Spring Boot 项⽬，我们可以使⽤ Spring 官⽅提供的⽹⻚版来创建 Spring Boot 项⽬。

⽹⻚版创建项⽬先访问：https://start.spring.io，如下图所⽰：

Idea创建项⽬时, 显⽰的界⾯, 就是来⾃于这个⽹站, 所以⽹络不好的情况下, 这个界⾯也会打不开

点击⽣成按钮会下载⼀个 Spring Boot 的 zip 包，解压 zip 之后⽬录如下：

项⽬代码和⽬录介绍

观察pom⽂件

XML 复制代码 
<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
	xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 https://maven.apache.org/xsd/maven-4.0.0.xsd">
	<modelVersion>4.0.0</modelVersion>
	<parent>
		<groupId>org.springframework.boot</groupId>
		<artifactId>spring-boot-starter-parent</artifactId>
		<version>3.4.5</version>
		<relativePath/> <!-- lookup parent from repository -->
	</parent>
	<groupId>com.example</groupId>
	<artifactId>demo</artifactId>
	<version>0.0.1-SNAPSHOT</version>
	<name>demo</name>
	<description>Demo project for Spring Boot</description>
	<url/>
	<licenses>
		<license/>
	</licenses>
	<developers>
		<developer/>
	</developers>
	<scm>
		<connection/>
		<developerConnection/>
		<tag/>
		<url/>
	</scm>
	<properties>
		<java.version>17</java.version>
	</properties>
	<dependencies>
		<dependency>
			<groupId>org.springframework.boot</groupId>
			<artifactId>spring-boot-starter</artifactId>
		</dependency>

		<dependency>
			<groupId>org.springframework.boot</groupId>
			<artifactId>spring-boot-starter-test</artifactId>
			<scope>test</scope>
		</dependency>
	</dependencies>

	<build>
		<plugins>
			<plugin>
				<groupId>org.springframework.boot</groupId>
				<artifactId>spring-boot-maven-plugin</artifactId>
			</plugin>
		</plugins>
	</build>

</project>

pom.xml⽂件⾥的具体信息, 不需要过度关注, 我们主要看 标签⾥⾯的内容

pom⽂件中, 引⼊了两个依赖

  • spring-boot-starter-web：包含了web应⽤开发所需要的常⻅依赖
  • spring-boot-starter-test：包含了单元测试所需要的常⻅依赖

⽗⼯程

但是我们发现, 这个依赖没有指定具体的版本号, 但我们的jar包也正常引⼊到项⽬中了.并且查看的话, 是有版本号的.

我们来看看本地仓库的的jar包是否下载下来了呢?

也下载下来了

为什么没有指定 , 程序也可以正常运⾏呢?

因为每⼀个SpringBoot⼯程，都有⼀个⽗⼯程. 依赖的版本号，在⽗⼯程中统⼀管理

⽗⼯程指定版本号后, 就会⾃动引⼊和所指定版本对应的依赖, 创建的SpringBoot项⽬, 会继承 SpringBoot⽗⼯程

⽬录介绍

Spring Boot 项⽬有两个主要的⽬录：

  • src/main/java: Java 源代码
  • src/main/resources: 为静态资源或配置⽂件：
  • /static：静态资源⽂件夹, ⽐如前期学的js, css, html等静态⽂件, 不需要服务器数据进⾏绑定的 ⻚⾯
  • /templates：模版资源⽂件夹, 主要存放动态模板⽂件, ⽐如JSP, Freemarker, Thymeleaf等需 要服务器动态渲染数据的⽂件
  • src/test/java: 测试代码源代码
  • target: 编译后的⽂件路径
  • pom.xml: maven 配置⽂件

运⾏项⽬

点击启动类的 main ⽅法就可以运⾏ Spring Boot 项⽬了，启动成功如下图所⽰：

输出 Hello world

要⽤ Spring Boot 来实现和浏览器及⽤⼾的交互，在创建的项⽬包路径下创建 UserController ⽂件，实现代码如下：

java 复制代码 
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RestController;

@RestController
@RequestMapping("/user")
public class UserController {

    @RequestMapping("/sayhi")
    public String test1() {
        return "this is test1";
    }
}

重新启动项⽬，访问 http://127.0.0.1:8080/user/test1 最终效果如下：

Web服务器

浏览器和服务器两端进⾏数据交互, 使⽤的就是HTTP协议

我们已经学习了 HTTP 协议, 知道了 HTTP 协议就是 HTTP 客⼾端和 HTTP 服务器之间的交互数据 的格式

Web 服务器就是对HTTP协议进⾏封装, 程序员不需要直接对协议进⾏操作(⾃⼰写代码去解析http协议 规则)，让Web开发更加便捷, 所以Web服务器也被称为WWW服务器, HTTP服务器, 主要功能是提供⽹ 上信息浏览服务

常⻅的Web服务器有: Apache,Nginx, IIS, Tomcat, Jboss等

SpringBoot 内置了Tomcat服务器, ⽆需配置即可直接运⾏

Tocmat默认端⼝号是8080, 所以我们程序访问时的端⼝号也是8080

请求响应流程分析

浏览器输⼊URL之后, 发起请求, 就和服务器之间建⽴了连接

服务器:

浏览器：

  • 输⼊⽹址：http://127.0.0.1:8080/hello
  • 通过IP地址127.0.0.1定位到⽹络上的⼀台计算机, 127.0.0.1就是本机
  • 通过端⼝号8080找到计算机上对应的进程 , 也就是在本地计算机中找到正在运⾏的8080端⼝的 程序
  • /user/sayhi是请求资源位置
  • 资源：对计算机⽽⾔资源就是数据
  • web资源：通过⽹络可以访问到的资源（通常是指存放在服务器上的数据）
  • http://127.0.0.1:8080/user/sayhi ，就是向本地计算机中的8080端⼝程序，获取资源位置 是/user/sayhi的数据
  • 8080端⼝程序，在服务器找/hello位置的资源数据，发给浏览器

服务器：

  • 接收到浏览器发送的信息（如：/user/sayhi）
  • 在服务器上找到/user/sayhi的资源
  • 把资源发送给浏览器

访问出错怎么办

404

404 表⽰⽤⼾访问的资源不存在，⼤概率是 URL 的路径写的不正确

错误实例1: url单词拼错

错误实例2: 注解写错

java 复制代码 
import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RestController;

@Controller
@RequestMapping("/user")
public class UserController {

    @RequestMapping("/sayhi")
    public String test1() {
        return "this is test1";
    }
}

访问时也会报错404

通过Fiddler观察Http请求

500

服务器出现内部错误. ⼀般是服务器的代码执⾏过程中遇到了⼀些特殊情况(服务器异常崩溃)会产⽣这 个状态码

错误实例:

java 复制代码 
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RestController;

@RestController
@RequestMapping("/user")
public class UserController {

    @RequestMapping("/sayhi")
    public String test1() {
        int x = 1 / 0;
        return "this is test1";
    }
}

重启 Tomcat 服务器.

重新访问⻚⾯, 可以看到:

此时, 程序后端控制台已经打印了具体的异常调⽤栈

异常信息⾥已经提⽰了出现异常的代码是UserController.java的第13⾏

错误原因是算术异常: 除数为0

按照异常提⽰, 去解决对应的问题即可.

⽆法访问此⽹站

⼀般是 Tomcat 启动失败了.

这种情况⼀般是服务未成功启动, 也就是tomcat未启动,或者IP/端⼝写错

打开Fiddler的话, 界⾯如下:

总结

  • Spring Boot 是为了快速开发 Spring ⽽诞⽣的, Spring Boot 具备:
  • Spring Boot 提供了启动添加依赖的功能, 可以快速集成框架
  • 内置web服务器，⽆需配置 Tomcat 等 Web服务器，直接运⾏和部署程序
  • 可以完全抛弃繁琐的 XML，使⽤注解和配置的⽅式进⾏开发
  • ⽀持更多的监控的指标，可以更好的了解项⽬的运⾏情况等特点

Spring Boot 可使⽤ Idea 或⽹⻚创建，它的设计思想是约定⼤于配置，类上标注 @SpringBootApplication 就可以启动 Spring Boot 项⽬了.

相关推荐
往日时光--1 分钟前
Centos上搭建 OpenResty
java
普通的冒险者4 分钟前
用java实现内网通讯，可多开客户端链接同一个服务器
java·开发语言
Muroidea5 分钟前
解决RedisTemplate的json反序列泛型丢失问题
java·开发语言·json
江沉晚呤时9 分钟前
使用 C# 入门深度学习：线性代数详细讲解
人工智能·后端·深度学习·线性代数·c#·.netcore
雪碧聊技术29 分钟前
在SpringBoot项目中，使用单元测试@Test
java·spring boot·单元测试
只因从未离去41 分钟前
黑马Java基础笔记-13常用查找算法
java·开发语言·笔记
奈何不吃鱼42 分钟前
【Redis】二、Redis常用数据类型命令学习
java·redis·学习
夏季疯43 分钟前
学习笔记：黑马程序员JavaWeb开发教程(2025.4.9)
java·笔记·学习
xiaolin033343 分钟前
【Netty】- NIO基础2
java·nio·多路复用·selector
救救孩子把1 小时前
打造一个支持MySQL查询的MCP同步插件：Java实现
java·mysql·mcp·stdio
热门推荐
01从零安装 LLaMA-Factory 微调 Qwen 大模型成功及所有的坑02KGG转MP3工具|非KGM文件|解密音频03YOLOv8入门 | 重要性能衡量指标、训练结果评价及分析及影响mAP的因素【发论文关注的指标】04【SpeedAI科研小助手】2分钟极速解决知网维普重复率、AIGC率过高，一键全文降！文件格式不变，公式都保留的！05组基轨迹建模 GBTM的介绍与实现（Stata 或 R）06DeepSeek各版本说明与优缺点分析07VMware虚拟机安装Win7专业版保姆级教程（附镜像包）08YOLOv5改进 | 添加CA注意力机制 + 增加预测层 + 更换损失函数之GIoU09Coze扣子平台完整体验和实践（附国内和国际版对比）10Windows下Qt5.14.2连接华为IoTDA平台