Spring Boot 测试与单元测试：如何让你的应用在测试面前从容不迫？

🏆本文收录于「滚雪球学SpringBoot」专栏(全网一个名)，手把手带你零基础入门Spring Boot，从入门到就业，助你早日登顶实现财富自由🚀；同时，欢迎大家关注&&收藏&&订阅！持续更新中，up！up！up！！

环境说明：Windows 10 + IntelliJ IDEA 2021.3.2 + Jdk 1.8

前言：

随着现代开发流程中自动化测试的普及，测试变得越来越重要，尤其是在构建高质量、稳定的企业级应用时，测试的重要性不言而喻。作为开发者，了解如何在 Spring Boot 中高效地进行单元测试、集成测试以及 RESTful API 测试，不仅能够提高开发效率，还能帮助我们确保应用在各类场景下的正确性和健壮性。

测试不仅仅是“为了通过测试”，它也是软件质量的保障！Spring Boot 提供了强大的测试框架，让我们可以轻松实现各种测试策略，从基础的单元测试到复杂的集成测试，甚至是 API 测试。

在本文中，我将带你深入理解 Spring Boot 的测试机制，讲解如何使用 JUnit 和 Mockito 进行单元测试，如何通过 @SpringBootTest 和 @WebMvcTest 注解进行集成测试和控制器测试，最后，我还将介绍如何使用 MockMvc 来测试 RESTful API，保证你的接口能够经得起真正的生产环境的考验。

准备好了吗？让我们开始吧！🚀

🔧 Spring Boot 测试基础

Spring Boot 提供了完整的测试支持，让开发者可以在不同的层次上进行测试。无论是单元测试、集成测试，还是 RESTful API 测试，Spring Boot 都提供了易于使用的工具。

Spring Boot 测试框架是基于 JUnit 和 Spring Test 来构建的，它利用 Spring 上下文加载机制，能够模拟完整的应用环境进行测试。在 Spring Boot 中，测试通常分为几种类型：单元测试、集成测试、Web 层测试等。

1. Spring Boot 测试的核心组件

• JUnit 5：Spring Boot 默认使用 JUnit 5 作为测试框架，它为我们提供了非常丰富的功能，如断言、测试生命周期、测试注解等。
• Mockito：Mockito 是一个流行的 Java 模拟框架，它可以帮助我们在单元测试中模拟依赖组件，避免测试中的依赖干扰。
• @SpringBootTest：用于加载整个 Spring 上下文进行集成测试，适用于测试整个 Spring Boot 应用。
• @WebMvcTest：用于测试 Spring MVC 控制器，适用于单元测试中对控制器的精细化测试。

🧪 使用 JUnit 与 Mockito 进行单元测试

1. 使用 JUnit 编写基础单元测试

JUnit 是 Java 最常用的单元测试框架，它提供了丰富的功能来简化测试的编写与执行。在 Spring Boot 中，单元测试通常会结合 JUnit 5 来使用。

首先，我们需要为我们的服务类编写单元测试。假设我们有一个简单的服务类 UserService：

@Service
public class UserService {

    public String getUserById(Long id) {
        // 假设返回的是一个数据库查询结果
        if (id == 1L) {
            return "User1";
        } else {
            return "Unknown";
        }
    }
}

接下来，我们使用 JUnit 5 编写对 UserService 的单元测试：

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

public class UserServiceTest {

    @Test
    public void testGetUserById() {
        UserService userService = new UserService();
        String result = userService.getUserById(1L);
        assertEquals("User1", result, "Expected user is User1");
    }
}

在这个简单的例子中，我们编写了一个基本的测试方法 testGetUserById()，它验证了 getUserById 方法的返回值是否符合预期。

2. 使用 Mockito 进行模拟

在单元测试中，我们经常需要模拟外部依赖，如数据库、Web 服务等。Mockito 是一个非常强大的模拟框架，能够帮助我们在测试时模拟这些依赖，避免不必要的外部依赖干扰。

假设我们的 UserService 依赖一个 UserRepository，用于从数据库获取用户信息：

public interface UserRepository {
    User findById(Long id);
}

在测试时，我们可以使用 Mockito 来模拟 UserRepository，避免访问实际的数据库：

import static org.mockito.Mockito.*;

public class UserServiceTest {

    @Test
    public void testGetUserById() {
        // 模拟 UserRepository
        UserRepository userRepository = mock(UserRepository.class);
        when(userRepository.findById(1L)).thenReturn(new User(1L, "User1"));

        UserService userService = new UserService(userRepository);
        String result = userService.getUserById(1L);
        assertEquals("User1", result, "Expected user is User1");
    }
}

在这个测试中，我们通过 mock 创建了一个 UserRepository 的模拟对象，并指定了返回值。这样，UserService 在测试时不会实际访问数据库，而是依赖我们模拟的数据。

🏞️ @SpringBootTest 与 @WebMvcTest

Spring Boot 提供了两种非常常用的注解来进行测试：@SpringBootTest 和 @WebMvcTest，它们分别用于集成测试和控制器层的测试。

1. @SpringBootTest — 集成测试

@SpringBootTest 注解通常用于集成测试，它会启动整个 Spring Boot 上下文，加载所有的 Bean 和配置，适用于对应用进行全面的集成测试。例如，假设我们需要测试一个包含数据库和服务层的业务逻辑：

@SpringBootTest
public class UserServiceIntegrationTest {

    @Autowired
    private UserService userService;

    @Test
    public void testGetUserById() {
        String result = userService.getUserById(1L);
        assertEquals("User1", result, "Expected user is User1");
    }
}

通过 @SpringBootTest，我们可以测试整个应用的集成，确保各个层次的组件能够正确协同工作。

2. @WebMvcTest — 控制器层测试

当我们只需要测试 Web 层（控制器）时，可以使用 @WebMvcTest，它会只加载与 Web 层相关的组件，不会加载整个 Spring 上下文，适合进行轻量级的控制器测试。

假设我们有一个简单的控制器 UserController：

@RestController
public class UserController {

    @Autowired
    private UserService userService;

    @GetMapping("/user/{id}")
    public String getUser(@PathVariable Long id) {
        return userService.getUserById(id);
    }
}

我们可以使用 @WebMvcTest 对其进行测试：

@WebMvcTest(UserController.class)
public class UserControllerTest {

    @Autowired
    private MockMvc mockMvc;

    @MockBean
    private UserService userService;

    @Test
    public void testGetUser() throws Exception {
        when(userService.getUserById(1L)).thenReturn("User1");

        mockMvc.perform(get("/user/1"))
               .andExpect(status().isOk())
               .andExpect(content().string("User1"));
    }
}

在这个测试中，我们使用了 MockMvc 来模拟 HTTP 请求，验证控制器的行为。@MockBean 注解会将 UserService 模拟成一个 Bean，并注入到 UserController 中。

🧪 MockMvc 测试 RESTful API

在测试 RESTful API 时，MockMvc 是 Spring 提供的一个非常强大的工具，它允许我们模拟 HTTP 请求，并验证返回的结果。通过 MockMvc，我们可以轻松地测试 GET、POST、PUT、DELETE 等 HTTP 请求。

1. 测试 GET 请求

对于简单的 GET 请求，我们可以使用以下方式进行测试：

@Test
public void testGetUser() throws Exception {
    when(userService.getUserById(1L)).thenReturn("User1");

    mockMvc.perform(get("/user/1"))
           .andExpect(status().isOk())
           .andExpect(content().string("User1"));
}

2. 测试 POST 请求

对于 POST 请求，我们可以使用以下方式进行测试：

@Test
public void testCreateUser() throws Exception {
    String json = "{\"id\": 1, \"name\": \"User1\"}";

    mockMvc.perform(post("/user")
            .contentType(MediaType.APPLICATION_JSON)
            .content(json))
            .andExpect(status().isCreated());
}

通过 MockMvc，我们可以模拟客户端发送的请求，验证响应状态、内容等。

🔍 集成测试与测试覆盖率工具

1. 集成测试

集成测试的目的是验证系统中各个模块是否能够协调工作。Spring Boot 提供了对集成测试的全面支持，通过 @SpringBootTest 可以启动完整的 Spring 容器进行集成测试。集成测试通常会验证数据库操作、服务调用和接口的协作等。

2. 测试覆盖率工具

测试覆盖率工具帮助我们衡量测试的有效性和代码的测试覆盖范围。常用的工具包括 JaCoCo 和 SonarQube。

• JaCoCo：JaCoCo 是一种非常流行的代码覆盖率工具，它能够生成代码覆盖率报告，并显示每个方法和行的覆盖情况。
• SonarQube：SonarQube 是一个全面的质量管理平台，它不仅可以分析代码质量，还能报告测试覆盖率和代码缺陷。

在 Spring Boot 中，我们可以通过配置插件来集成 JaCoCo，生成代码覆盖率报告。

结语：

在这篇文章中，我们详细介绍了 Spring Boot 中的测试机制，包括单元测试、集成测试、Web 层测试等方面的内容。通过掌握 JUnit 和 Mockito，使用 @SpringBootTest、@WebMvcTest 等注解，我们可以在不同层级上进行高效的测试，确保我们的应用质量高、健壮、可维护。

测试不仅仅是为了通过，它是保障应用质量的重要手段！希望本文能够帮助你理解并应用 Spring Boot 的测试框架，让你的应用在面对各种测试时从容不迫！🔧💡

🧧福利赠与你🧧

  无论你是计算机专业的学生，还是对编程有兴趣的小伙伴，都建议直接毫无顾忌的学习此专栏「滚雪球学SpringBoot」专栏(全网一个名)，bug菌郑重承诺，凡是学习此专栏的同学，均能获取到所需的知识和技能，全网最快速入门SpringBoot，就像滚雪球一样，越滚越大， 无边无际，指数级提升。

  最后，如果这篇文章对你有所帮助，帮忙给作者来个一键三连，关注、点赞、收藏，您的支持就是我坚持写作最大的动力。

  同时欢迎大家关注公众号:「猿圈奇妙屋」 ，以便学习更多同类型的技术文章，免费白嫖最新BAT互联网公司面试题、4000G pdf电子书籍、简历模板、技术文章Markdown文档等海量资料。

✨️ Who am I?

我是bug菌(全网一个名)，CSDN | 掘金 | InfoQ | 51CTO | 华为云 | 阿里云 | 腾讯云 等社区博客专家，C站博客之星Top30，华为云多年度十佳博主/价值贡献奖，掘金多年度人气作者Top40，掘金等各大社区平台签约作者，51CTO年度博主Top12，掘金/InfoQ/51CTO等社区优质创作者；全网粉丝合计 30w+；更多精彩福利点击这里；硬核微信公众号「猿圈奇妙屋」，欢迎你的加入！免费白嫖最新BAT互联网公司面试真题、4000G PDF电子书籍、简历模板等海量资料，你想要的我都有，关键是你不来拿。

-End-