SpringBoot单元测试与集成测试：Mockito+Testcontainers实战

在软件开发过程中，测试是保证代码质量和系统稳定性的关键环节。Spring Boot作为一款流行的Java开发框架，为开发者提供了便捷的开发体验。而单元测试和集成测试则是Spring Boot项目中不可或缺的部分。Mockito是一个强大的Java模拟框架，用于创建和管理模拟对象，而Testcontainers则是一个用于在容器中运行测试的开源库。本文将详细介绍如何在Spring Boot项目中使用

fanxbl957

770人浏览 · 2025-04-09 14:59:22

fanxbl957 · 2025-04-09 14:59:22 发布

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

SpringBoot单元测试与集成测试：Mockito+Testcontainers实战

一、引言

二、环境准备

2.1 项目初始化

首先，我们需要创建一个新的Spring Boot项目。可以使用Spring Initializr（https://start.spring.io/）来快速生成项目骨架，选择所需的依赖，如Spring Web、Spring Data JPA等。

2.2 添加依赖

在pom.xml文件中添加Mockito和Testcontainers的依赖：

<dependencies>
    <!-- Spring Boot Test -->
    <dependency>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-test</artifactId>
        <scope>test</scope>
    </dependency>
    <!-- Mockito -->
    <dependency>
        <groupId>org.mockito</groupId>
        <artifactId>mockito-core</artifactId>
        <scope>test</scope>
    </dependency>
    <!-- Testcontainers -->
    <dependency>
        <groupId>org.testcontainers</groupId>
        <artifactId>testcontainers</artifactId>
        <version>1.17.6</version>
        <scope>test</scope>
    </dependency>
    <dependency>
        <groupId>org.testcontainers</groupId>
        <artifactId>junit-jupiter</artifactId>
        <version>1.17.6</version>
        <scope>test</scope>
    </dependency>
    <dependency>
        <groupId>org.testcontainers</groupId>
        <artifactId>mysql</artifactId>
        <version>1.17.6</version>
        <scope>test</scope>
    </dependency>
</dependencies>

三、Mockito单元测试实战

3.1 Mockito简介

Mockito是一个用于创建和管理模拟对象的Java框架。它可以帮助我们在单元测试中隔离被测试对象与外部依赖，从而更专注于测试对象的逻辑。

3.2 简单示例

假设我们有一个UserService类，它依赖于UserRepository接口：

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

// User.java
public class User {
    private Long id;
    private String name;

    // Getters and Setters
    public Long getId() {
        return id;
    }

    public void setId(Long id) {
        this.id = id;
    }

    public String getName() {
        return name;
    }

    public void setName(String name) {
        this.name = name;
    }
}

// UserService.java
public class UserService {
    private final UserRepository userRepository;

    public UserService(UserRepository userRepository) {
        this.userRepository = userRepository;
    }

    public User getUserById(Long id) {
        return userRepository.findById(id);
    }
}

下面是使用Mockito进行单元测试的代码：

import org.junit.jupiter.api.Test;
import org.mockito.Mockito;

import static org.junit.jupiter.api.Assertions.assertEquals;
import static org.mockito.Mockito.when;

public class UserServiceTest {

    @Test
    public void testGetUserById() {
        // 创建Mock对象
        UserRepository userRepository = Mockito.mock(UserRepository.class);
        // 创建一个User对象
        User user = new User();
        user.setId(1L);
        user.setName("John");
        // 定义Mock对象的行为
        when(userRepository.findById(1L)).thenReturn(user);

        // 创建被测试对象
        UserService userService = new UserService(userRepository);
        // 调用被测试方法
        User result = userService.getUserById(1L);

        // 验证结果
        assertEquals("John", result.getName());
        // 验证Mock对象的方法是否被调用
        Mockito.verify(userRepository).findById(1L);
    }
}

3.3 Mockito常用方法

Mockito.mock(Class<T> classToMock)：创建一个Mock对象。
when(mock.method()).thenReturn(value)：定义Mock对象的方法返回值。
Mockito.verify(mock).method()：验证Mock对象的方法是否被调用。

四、Testcontainers集成测试实战

4.1 Testcontainers简介

Testcontainers是一个用于在容器中运行测试的开源库，它可以帮助我们在测试环境中模拟真实的外部依赖，如数据库、消息队列等。

4.2 使用Testcontainers进行数据库集成测试

假设我们有一个Spring Boot项目，使用Spring Data JPA与MySQL数据库交互。

4.2.1 配置Testcontainers

import org.junit.jupiter.api.Test;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.boot.test.autoconfigure.jdbc.AutoConfigureTestDatabase;
import org.springframework.boot.test.autoconfigure.orm.jpa.DataJpaTest;
import org.springframework.test.context.DynamicPropertyRegistry;
import org.springframework.test.context.DynamicPropertySource;
import org.testcontainers.containers.MySQLContainer;
import org.testcontainers.junit.jupiter.Container;
import org.testcontainers.junit.jupiter.Testcontainers;

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

@DataJpaTest
@AutoConfigureTestDatabase(replace = AutoConfigureTestDatabase.Replace.NONE)
@Testcontainers
public class UserRepositoryIntegrationTest {

    @Container
    private static final MySQLContainer<?> mysqlContainer = new MySQLContainer<>("mysql:8.0")
           .withDatabaseName("testdb")
           .withUsername("testuser")
           .withPassword("testpass");

    @DynamicPropertySource
    static void registerDatabaseProperties(DynamicPropertyRegistry registry) {
        registry.add("spring.datasource.url", mysqlContainer::getJdbcUrl);
        registry.add("spring.datasource.username", mysqlContainer::getUsername);
        registry.add("spring.datasource.password", mysqlContainer::getPassword);
    }

    @Autowired
    private UserRepository userRepository;

    @Test
    public void testSaveAndFindUser() {
        User user = new User();
        user.setName("Alice");
        User savedUser = userRepository.save(user);

        User foundUser = userRepository.findById(savedUser.getId()).orElse(null);
        assertEquals("Alice", foundUser.getName());
    }
}

4.2.2 代码解释

@Container：标记一个静态的容器实例，Testcontainers会在测试开始前启动该容器，测试结束后停止。
@DynamicPropertySource：用于动态配置Spring Boot的属性，这里我们将数据库的连接信息配置为Testcontainers启动的MySQL容器的信息。
@DataJpaTest：用于测试Spring Data JPA的仓库，会自动配置一个嵌入式数据库或使用Testcontainers提供的数据库。

五、总结

通过本文的介绍，我们学习了如何在Spring Boot项目中使用Mockito进行单元测试，以及如何使用Testcontainers进行集成测试。Mockito可以帮助我们隔离外部依赖，专注于被测试对象的逻辑，而Testcontainers则可以在测试环境中模拟真实的外部依赖，确保测试的准确性和可靠性。在实际开发中，合理运用单元测试和集成测试可以提高代码质量，减少潜在的bug。