首页 > 文章 > java教程

SpringBoot单元测试与Mockito使用教程

时间：2025-10-19 13:18:35 433浏览收藏

想提升Spring Boot应用的质量？本文为你提供一份全面的单元测试与Mockito实践指南。我们将深入探讨如何在Spring Boot项目中运用JUnit、Mockito和集成测试，覆盖Controller、Service和Repository三层，教你掌握各种测试场景下的最佳策略。例如，何时利用Mockito模拟对象以隔离依赖，何时使用JUnit进行常规测试。通过学习本文，你将能为你的Spring Boot应用构建更可靠、更健壮的测试体系，有效提高代码质量，减少bug，提升开发效率。掌握这些测试技巧，让你的Spring Boot项目更上一层楼！

Spring Boot 应用中的单元测试、Mockito 和集成测试：最佳实践

第一段引用上面的摘要：

本文旨在帮助初学者理解在 Spring Boot 应用中何时以及如何使用 JUnit、Mockito 和集成测试。我们将探讨这些测试框架在 Controller、Service 和 Repository 层中的应用，并提供示例说明何时使用 Mockito 模拟对象，以及何时使用 JUnit 进行常规测试。通过本文，你将能够为你的 Spring Boot 应用构建更健壮、更可靠的测试策略。

单元测试、Mockito 和集成测试：概念与应用

在 Spring Boot 应用开发中，测试是保证代码质量的关键环节。单元测试、Mockito 和集成测试是常用的测试手段，它们各自侧重点不同，适用于不同的测试场景。

单元测试 (Unit Testing): 侧重于对代码中的最小可测试单元（通常是一个方法或一个类）进行独立测试，验证其功能是否符合预期。JUnit 是 Java 中最流行的单元测试框架。
Mockito: 是一个 Mock 框架，用于创建和配置 Mock 对象。Mock 对象是模拟真实对象的替代品，用于隔离被测单元的依赖，以便专注于测试被测单元自身的逻辑。
集成测试 (Integration Testing): 侧重于测试不同模块或组件之间的交互是否正确。在 Spring Boot 应用中，集成测试通常涉及测试 Controller、Service 和 Repository 层之间的协同工作。

各层测试策略：Controller、Service 和 Repository

针对 Spring Boot 应用的 Controller、Service 和 Repository 层，我们可以采用不同的测试策略：

1. Controller 层测试

Controller 层负责处理 HTTP 请求并返回响应。测试 Controller 层主要验证以下内容：

请求映射是否正确
请求参数绑定是否正确
业务逻辑调用是否正确
响应状态码和内容是否正确

通常可以使用 JUnit 配合 Spring 的 MockMvc 工具进行 Controller 层的测试。MockMvc 允许你模拟 HTTP 请求，并验证 Controller 的行为。

示例：

@WebMvcTest(MyController.class)
public class MyControllerTest {

    @Autowired
    private MockMvc mockMvc;

    @MockBean
    private MyService myService;

    @Test
    public void testGetRequest() throws Exception {
        when(myService.getData()).thenReturn("Hello, World!");

        mockMvc.perform(MockMvcRequestBuilders.get("/my-endpoint"))
                .andExpect(status().isOk())
                .andExpect(content().string("Hello, World!"));
    }
}

说明：

@WebMvcTest 注解用于指定要测试的 Controller 类。
@MockBean 注解用于创建 MyService 的 Mock 对象，并将其注入到 Controller 中。
when(myService.getData()).thenReturn("Hello, World!") 用于配置 Mock 对象的行为，当调用 myService.getData() 方法时，返回 "Hello, World!"。
mockMvc.perform(...) 用于模拟 HTTP 请求。
andExpect(...) 用于验证响应状态码和内容。

2. Service 层测试

Service 层负责处理业务逻辑。测试 Service 层主要验证以下内容：

业务逻辑是否正确
数据处理是否正确
与 Repository 层的交互是否正确

可以使用 JUnit 和 Mockito 对 Service 层进行测试。Mockito 可以用于 Mock Repository 层的依赖，以便专注于测试 Service 层自身的逻辑。

示例：

@ExtendWith(MockitoExtension.class)
public class MyServiceTest {

    @InjectMocks
    private MyService myService;

    @Mock
    private MyRepository myRepository;

    @Test
    public void testGetData() {
        when(myRepository.findData()).thenReturn("Data from repository");

        String result = myService.getData();

        assertEquals("Data from repository", result);
    }
}

说明：

@ExtendWith(MockitoExtension.class) 注解用于启用 Mockito 支持。
@InjectMocks 注解用于将 MyService 实例注入到测试类中。
@Mock 注解用于创建 MyRepository 的 Mock 对象。
when(myRepository.findData()).thenReturn("Data from repository") 用于配置 Mock 对象的行为。
assertEquals("Data from repository", result) 用于验证结果是否符合预期。

3. Repository 层测试

Repository 层负责与数据库交互。测试 Repository 层主要验证以下内容：

数据访问是否正确
SQL 查询是否正确
数据持久化是否正确

可以使用 JUnit 和 Spring 的 DataJpaTest 注解进行 Repository 层的测试。DataJpaTest 提供了一个嵌入式数据库，用于测试数据访问逻辑。

示例：

@DataJpaTest
public class MyRepositoryTest {

    @Autowired
    private MyRepository myRepository;

    @Test
    public void testFindData() {
        MyEntity entity = new MyEntity();
        entity.setData("Test data");
        myRepository.save(entity);

        MyEntity foundEntity = myRepository.findById(entity.getId()).orElse(null);

        assertEquals("Test data", foundEntity.getData());
    }
}

说明：