🎓博主介绍：Java、Python、js全栈开发 “多面手”，精通多种编程语言和技术，痴迷于人工智能领域。秉持着对技术的热爱与执着，持续探索创新，愿在此分享交流和学习，与大家共进步。
📖DeepSeek-行业融合之万象视界(附实战案例详解100+)
📖全栈开发环境搭建运行攻略：多语言一站式指南(环境搭建+运行+调试+发布+保姆级详解)
👉感兴趣的可以先收藏起来，希望帮助更多的人

SpringBoot单元测试完全手册：MockMVC与JUnit5最佳实践

一、引言

在Spring Boot开发中，单元测试是保证代码质量、提高开发效率的重要手段。MockMVC和JUnit 5是Spring Boot生态中常用的单元测试工具，MockMVC可以模拟HTTP请求，对Spring MVC控制器进行测试，而JUnit 5则提供了丰富的测试注解和断言方式，帮助我们编写更加简洁、灵活的测试用例。本文将详细介绍如何使用MockMVC和JUnit 5进行Spring Boot应用的单元测试，并给出最佳实践示例。

二、环境准备

2.1 添加依赖

在pom.xml文件中添加必要的依赖，确保项目能够使用MockMVC和JUnit 5进行测试：

<dependencies>
    <!-- Spring Boot Starter Web -->
    <dependency>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-web</artifactId>
    </dependency>
    <!-- Spring Boot Starter Test -->
    <dependency>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-test</artifactId>
        <scope>test</scope>
    </dependency>
    <!-- JUnit 5 -->
    <dependency>
        <groupId>org.junit.jupiter</groupId>
        <artifactId>junit-jupiter-api</artifactId>
        <scope>test</scope>
    </dependency>
    <dependency>
        <groupId>org.junit.jupiter</groupId>
        <artifactId>junit-jupiter-engine</artifactId>
        <scope>test</scope>
    </dependency>
</dependencies>

2.2 配置JUnit 5

确保在pom.xml中配置了JUnit 5作为测试运行器：

<build>
    <plugins>
        <plugin>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-maven-plugin</artifactId>
        </plugin>
        <plugin>
            <groupId>org.apache.maven.plugins</groupId>
            <artifactId>maven-surefire-plugin</artifactId>
            <version>3.0.0-M5</version>
            <configuration>
                <includes>
                    <include>**/*Test.java</include>
                </includes>
                <excludes>
                    <exclude>**/Abstract*.java</exclude>
                </excludes>
            </configuration>
        </plugin>
    </plugins>
</build>

三、MockMVC基础

3.1 什么是MockMVC

MockMVC是Spring MVC提供的一个测试工具，它允许我们在不启动完整的HTTP服务器的情况下模拟HTTP请求，对Spring MVC控制器进行单元测试。通过MockMVC，我们可以方便地测试控制器的请求映射、参数绑定、视图解析等功能。

3.2 创建MockMVC实例

在测试类中，我们可以使用MockMvcBuilders来创建MockMvc实例。有两种常见的创建方式：

3.2.1 独立安装方式

独立安装方式只对指定的控制器进行测试，不加载整个Spring应用上下文：

import org.junit.jupiter.api.Test;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.boot.test.autoconfigure.web.servlet.WebMvcTest;
import org.springframework.test.web.servlet.MockMvc;
import org.springframework.test.web.servlet.setup.MockMvcBuilders;
import org.springframework.web.context.WebApplicationContext;

import static org.springframework.test.web.servlet.request.MockMvcRequestBuilders.get;
import static org.springframework.test.web.servlet.result.MockMvcResultMatchers.status;

@WebMvcTest(YourController.class)
public class YourControllerTest {

    @Autowired
    private WebApplicationContext webApplicationContext;

    private MockMvc mockMvc;

    @Test
    public void testIndependentSetup() throws Exception {
        mockMvc = MockMvcBuilders.standaloneSetup(new YourController()).build();
        mockMvc.perform(get("/your-url"))
               .andExpect(status().isOk());
    }
}

3.2.2 Web应用上下文方式

Web应用上下文方式会加载整个Spring应用上下文，对所有的控制器进行测试：

import org.junit.jupiter.api.Test;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.boot.test.autoconfigure.web.servlet.WebMvcTest;
import org.springframework.test.web.servlet.MockMvc;
import org.springframework.test.web.servlet.setup.MockMvcBuilders;
import org.springframework.web.context.WebApplicationContext;

import static org.springframework.test.web.servlet.request.MockMvcRequestBuilders.get;
import static org.springframework.test.web.servlet.result.MockMvcResultMatchers.status;

@WebMvcTest(YourController.class)
public class YourControllerTest {

    @Autowired
    private WebApplicationContext webApplicationContext;

    private MockMvc mockMvc;

    @Test
    public void testWebAppContextSetup() throws Exception {
        mockMvc = MockMvcBuilders.webAppContextSetup(webApplicationContext).build();
        mockMvc.perform(get("/your-url"))
               .andExpect(status().isOk());
    }
}

四、JUnit 5基础

4.1 JUnit 5的新特性

JUnit 5引入了许多新特性，如动态测试、参数化测试、嵌套测试等，这些特性使得测试代码更加简洁、灵活。以下是一些常用的JUnit 5注解：

• @Test：标记一个测试方法。
• @BeforeEach：在每个测试方法执行之前执行。
• @AfterEach：在每个测试方法执行之后执行。
• @BeforeAll：在所有测试方法执行之前执行，必须是静态方法。
• @AfterAll：在所有测试方法执行之后执行，必须是静态方法。
• @DisplayName：为测试类或测试方法设置显示名称。

4.2 编写简单的JUnit 5测试用例

import org.junit.jupiter.api.BeforeEach;
import org.junit.jupiter.api.DisplayName;
import org.junit.jupiter.api.Test;

import static org.junit.jupiter.api.Assertions.assertEquals;

class CalculatorTest {

    private Calculator calculator;

    @BeforeEach
    void setUp() {
        calculator = new Calculator();
    }

    @Test
    @DisplayName("测试加法运算")
    void testAdd() {
        int result = calculator.add(2, 3);
        assertEquals(5, result);
    }
}

class Calculator {
    public int add(int a, int b) {
        return a + b;
    }
}

五、MockMVC与JUnit 5结合的最佳实践

5.1 测试GET请求

import org.junit.jupiter.api.Test;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.boot.test.autoconfigure.web.servlet.WebMvcTest;
import org.springframework.test.web.servlet.MockMvc;

import static org.springframework.test.web.servlet.request.MockMvcRequestBuilders.get;
import static org.springframework.test.web.servlet.result.MockMvcResultMatchers.content;
import static org.springframework.test.web.servlet.result.MockMvcResultMatchers.status;

@WebMvcTest(YourController.class)
public class YourControllerTest {

    @Autowired
    private MockMvc mockMvc;

    @Test
    public void testGetMapping() throws Exception {
        mockMvc.perform(get("/your-url"))
               .andExpect(status().isOk())
               .andExpect(content().string("Hello, World!"));
    }
}

5.2 测试POST请求

import org.junit.jupiter.api.Test;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.boot.test.autoconfigure.web.servlet.WebMvcTest;
import org.springframework.http.MediaType;
import org.springframework.test.web.servlet.MockMvc;

import static org.springframework.test.web.servlet.request.MockMvcRequestBuilders.post;
import static org.springframework.test.web.servlet.result.MockMvcResultMatchers.status;

@WebMvcTest(YourController.class)
public class YourControllerTest {

    @Autowired
    private MockMvc mockMvc;

    @Test
    public void testPostMapping() throws Exception {
        String requestBody = "{\"name\": \"John\", \"age\": 30}";
        mockMvc.perform(post("/your-url")
               .contentType(MediaType.APPLICATION_JSON)
               .content(requestBody))
               .andExpect(status().isOk());
    }
}

5.3 测试带参数的请求

import org.junit.jupiter.api.Test;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.boot.test.autoconfigure.web.servlet.WebMvcTest;
import org.springframework.test.web.servlet.MockMvc;

import static org.springframework.test.web.servlet.request.MockMvcRequestBuilders.get;
import static org.springframework.test.web.servlet.result.MockMvcResultMatchers.status;

@WebMvcTest(YourController.class)
public class YourControllerTest {

    @Autowired
    private MockMvc mockMvc;

    @Test
    public void testRequestWithParams() throws Exception {
        mockMvc.perform(get("/your-url")
               .param("name", "John")
               .param("age", "30"))
               .andExpect(status().isOk());
    }
}

5.4 测试异常处理

import org.junit.jupiter.api.Test;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.boot.test.autoconfigure.web.servlet.WebMvcTest;
import org.springframework.test.web.servlet.MockMvc;

import static org.springframework.test.web.servlet.request.MockMvcRequestBuilders.get;
import static org.springframework.test.web.servlet.result.MockMvcResultMatchers.status;

@WebMvcTest(YourController.class)
public class YourControllerTest {

    @Autowired
    private MockMvc mockMvc;

    @Test
    public void testExceptionHandling() throws Exception {
        mockMvc.perform(get("/your-url-with-exception"))
               .andExpect(status().isInternalServerError());
    }
}

六、总结

通过本文的介绍，我们了解了MockMVC和JUnit 5在Spring Boot单元测试中的使用方法，以及它们结合的最佳实践。MockMVC可以帮助我们模拟HTTP请求，对Spring MVC控制器进行单元测试，而JUnit 5则提供了丰富的测试注解和断言方式，让我们的测试代码更加简洁、灵活。在实际开发中，我们应该充分利用这些工具，编写高质量的单元测试用例，保证代码的正确性和稳定性。