JUnit5单元测试入门与实战指南

学习文章要努力，但是不要急！今天的这篇文章《JUnit5单元测试入门与实战教程》将会介绍到等等知识点，如果你想深入学习文章，可以关注我！我会持续更新相关文章的，希望对大家都能有所帮助！

JUnit 5 是 Java 单元测试的主流框架，升级和使用它能提升代码质量。1. 添加 JUnit 5 依赖：Maven 或 Gradle 项目分别配置对应依赖，确保使用最新版本（如 5.11.0）。2. 编写测试类：使用 @Test、@BeforeEach、@AfterEach 等注解定义测试逻辑，并用 assertEquals 等方法进行断言。3. 使用 Mockito 模拟依赖：引入 Mockito 依赖后，通过 mock() 和 when(...).thenReturn(...) 构建模拟对象以隔离外部服务。4. 注意事项：命名清晰、避免测试私有方法、不重复测试逻辑、利用参数化测试提高效率。合理结合断言、生命周期管理和 Mock 工具，才能充分发挥单元测试的作用。

在Java开发中，单元测试是确保代码质量的重要手段。JUnit 5 是目前最主流的单元测试框架之一，它不仅支持函数式编程风格，还引入了更灵活的扩展机制。如果你还在用老版本的 JUnit 或者还没开始写单元测试，现在正是升级和入手的好时机。

1. 添加JUnit 5依赖

在开始写测试之前，首先要确保你的项目里已经引入了JUnit 5的依赖。如果你使用的是Maven项目，可以在pom.xml中添加如下内容：

    org.junit.jupiter
    junit-jupiter-api
    5.11.0
    test


    org.junit.jupiter
    junit-jupiter-engine
    5.11.0
    test

如果你使用Gradle，则可以这样添加：

testImplementation 'org.junit.jupiter:junit-jupiter:5.11.0'

注意：确保你使用的是最新版本（当前为5.11.0），以获得最新的特性和改进。

2. 编写第一个测试类

JUnit 5 使用注解来标识测试方法和生命周期行为。以下是一个简单的示例：

import org.junit.jupiter.api.*;

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

class CalculatorTest {

    @Test
    void add_TwoPositiveNumbers_ReturnsSum() {
        Calculator calculator = new Calculator();
        int result = calculator.add(2, 3);
        assertEquals(5, result, "2 + 3 should equal 5");
    }
}

说明：

• @Test 注解标记这是一个测试方法。
• assertEquals() 是常用的断言方法，用于验证预期值与实际结果是否一致。
• 可以加上可选的失败提示信息，帮助快速定位问题。

除了 @Test，还有几个常用注解：

• @BeforeEach / @AfterEach：每个测试方法执行前后运行。
• @BeforeAll / @AfterAll：整个测试类执行前后运行（必须是静态方法）。

3. 使用Mockito进行模拟测试

当你的测试对象依赖外部服务或复杂对象时，可以使用 Mockito 来创建“假”的依赖对象。

首先添加Mockito依赖：

    org.mockito
    mockito-core
    5.7.0
    test

然后你可以这样使用：

import static org.mockito.Mockito.*;
import static org.junit.jupiter.api.Assertions.*;

@TestInstance(TestInstance.Lifecycle.PER_CLASS)
public class OrderServiceTest {

    private OrderRepository orderRepository = mock(OrderRepository.class);
    private OrderService orderService = new OrderService(orderRepository);

    @Test
    void placeOrder_ShouldReturnTrue_WhenOrderSaved() {
        when(orderRepository.save(any(Order.class))).thenReturn(true);

        boolean result = orderService.placeOrder(new Order());
        assertTrue(result);
    }
}

要点：

• 使用 mock() 创建一个虚拟的对象。
• 使用 when(...).thenReturn(...) 定义其行为。
• 这样就可以在不调用真实数据库或网络请求的情况下完成测试。

4. 常见注意事项和技巧

• 测试命名要清晰：比如 methodName_condition_expectedBehavior，例如 add_negativeNumber_throwsException。
• 不要测试私有方法：只关注公共API的行为，私有方法的变化不应影响测试逻辑。
• 避免重复测试逻辑：一个测试方法只验证一个行为，便于定位问题。
• 利用参数化测试：JUnit 5 支持 @ParameterizedTest，可以对多个输入进行批量测试。

基本上就这些。JUnit 5 的用法虽然看起来简单，但在实际项目中结合好断言、生命周期管理和Mock工具，才能真正发挥出单元测试的价值。

文中关于的知识介绍，希望对你的学习有所帮助！若是受益匪浅，那就动动鼠标收藏这篇《JUnit5单元测试入门与实战指南》文章吧，也可关注golang学习网公众号了解相关技术文章。