SpringBoot 实战：JUnit5+MockMvc+Mockito 做好单元测试(1)

网上学习资料一大堆，但如果学到的知识不成体系，遇到问题时只是浅尝辄止，不再深入研究，那么很难做到真正的技术提升。

需要这份系统化的资料的朋友，可以戳这里获取

一个人可以走的很快，但一群人才能走的更远！不论你是正从事IT行业的老鸟或是对IT行业感兴趣的新人，都欢迎加入我们的的圈子（技术交流、学习资源、职场吐槽、大厂内推、面试辅导），让我们一起学习成长！

• JUnit Platform - 在 JVM 上启动测试框架

• JUnit Jupiter - 在 JUnit5 中编写测试和扩展

• JUnit Vintage - 提供运行基于 JUnit3 和 JUnit4 的测试引擎

从 SpringBoot 2.2.0 之后，Junit5 已经成为了默认的 Junit 版本。有了 JUnit Vintage，从 Junit4 迁移到 Junit5 的成本极低。所以本文就直接针对 Junit5 开始了。

版本

–

先说版本，是为了避免因为版本差异出现各种奇怪的问题：

• JDK：jdk8（小版本可以忽略）

• SpringBoot：2.5.2

• 继承spring-boot-starter-parent

• 依赖spring-boot-starter-web

• 依赖spring-boot-starter-test

• JUnit：5.7.2

• Mockito：3.9.0

• hamcrest：2.2

SpringBoot 的好处在于，只要继承spring-boot-starter-parent或引入spring-boot-dependencies，然后添加spring-boot-starter-test依赖即可。定义的 POM 内容如下：

<?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”>

4.0.0

org.springframework.boot

spring-boot-starter-parent

2.5.2

cn.howardliu.effective.spring

springboot-junit5-mockito

0.0.1-SNAPSHOT

springboot-junit5-mockio

org.springframework.boot

spring-boot-starter-web

org.springframework.boot

spring-boot-devtools

runtime

true

org.projectlombok

lombok

true

org.springframework.boot

spring-boot-starter-test

test

org.springframework.boot

spring-boot-maven-plugin

因为继承了spring-boot-starter-parent，所以我们依赖的spring-boot-starter-test不需要写具体的版本，可以直接集成父级的版本定义。其中，spring-boot-starter-web是用于提供 REST API 的 web 容器，spring-boot-starter-test可以提供各种测试框架的，spring-boot-maven-plugin是将 SpringBoot 应用打包为可执行 jar 的插件。

项目结构

---

因为是 DEMO 示例，我们实现一个 Echo 接口，能够接收请求参数，并返回加工后的字符串。按照惯例，我们使用万能的Hello, World!。

我们的项目结构如下：

├── pom.xml

└── src

├── main

│   ├── java

│   │   └── cn

│   │   └── howardliu

│   │   └── effective

│   │   └── spring

│   │   └── springbootjunit5mockio

│   │   ├── SpringbootJunit5MockioApplication.java

│   │   ├── controller

│   │   │   └── EchoController.java

│   │   └── service

│   │   ├── EchoService.java

│   │   └── impl

│   │   └── EchoServiceImpl.java

│   └── resources

│   └── application.yaml

└── test

└── java

└── cn

└── howardliu

└── effective

└── spring

└── springbootjunit5mockio

└── controller

├── EchoControllerMockTest.java

└── EchoControllerNoMockitoTest.java

• SpringbootJunit5MockioApplication：SpringBoot 应用启动入口

• EchoController：接口定义

• EchoService：实现业务逻辑接口

• EchoServiceImpl：接口实现

• EchoControllerMockTest：使用 Mock 代理 EchoService 实现

• EchoControllerNoMockitoTest：直接测试接口实现

EchoServiceImpl

我们看下EchoService的实现，这将是我们 DEMO 的核心实现：

@Service

public class EchoServiceImpl implements EchoService {

@Override

public String echo(String foo) {

return "Hello, " + foo;

}

}

EchoControllerNoMockitoTest

我们先使用 Junit5+MockMvc 实现 Controller 接口的普通调用，代码如下：

@SpringBootTest(classes = SpringbootJunit5MockioApplication.class)

@AutoConfigureMockMvc

class EchoControllerNoMockitoTest {

@Autowired

private MockMvc mockMvc;

@Test

void echo() throws Exception {

final String result = mockMvc.perform(

MockMvcRequestBuilders.get(“/echo/”)

.param(“name”, “看山”)

)

.andExpect(MockMvcResultMatchers.status().isOk())

.andDo(MockMvcResultHandlers.print())

既有适合小白学习的零基础资料，也有适合3年以上经验的小伙伴深入学习提升的进阶课程，涵盖了95%以上软件测试知识点，真正体系化！

由于文件比较多，这里只是将部分目录截图出来，全套包含大厂面经、学习笔记、源码讲义、实战项目、大纲路线、讲解视频，并且后续会持续更新

需要这份系统化的资料的朋友，可以戳这里获取

片转存中…(img-MVQwGZTk-1715877903156)]
[外链图片转存中…(img-RQSIXgDH-1715877903156)]
[外链图片转存中…(img-Mm3ctYbN-1715877903156)]

既有适合小白学习的零基础资料，也有适合3年以上经验的小伙伴深入学习提升的进阶课程，涵盖了95%以上软件测试知识点，真正体系化！

由于文件比较多，这里只是将部分目录截图出来，全套包含大厂面经、学习笔记、源码讲义、实战项目、大纲路线、讲解视频，并且后续会持续更新

需要这份系统化的资料的朋友，可以戳这里获取