JUnit5单元测试教程：入门到实战指南

想要提升你的Java代码质量吗？本文为你带来 **JUnit 5 单元测试入门与实战教程**。JUnit 5作为Java主流单元测试框架，不仅支持函数式编程，还拥有灵活的扩展机制。本文将从零开始，教你快速上手JUnit 5。首先，我们将介绍如何在Maven或Gradle项目中添加JUnit 5依赖（版本5.11.0）。接着，我们将学习如何编写测试类，利用`@Test`、`@BeforeEach`、`@AfterEach`等注解定义测试逻辑，并使用`assertEquals`等方法进行断言。此外，我们还将探讨如何使用Mockito模拟依赖，隔离外部服务，最后分享单元测试的注意事项，例如清晰的命名、避免测试私有方法等，助你编写高质量的单元测试用例，确保代码的健壮性和可靠性。

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中添加如下内容：

<dependency>
    <groupId>org.junit.jupiter</groupId>
    <artifactId>junit-jupiter-api</artifactId>
    <version>5.11.0</version>
    <scope>test</scope>
</dependency>
<dependency>
    <groupId>org.junit.jupiter</groupId>
    <artifactId>junit-jupiter-engine</artifactId>
    <version>5.11.0</version>
    <scope>test</scope>
</dependency>

如果你使用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依赖：

<dependency>
    <groupId>org.mockito</groupId>
    <artifactId>mockito-core</artifactId>
    <version>5.7.0</version>
    <scope>test</scope>
</dependency>

然后你可以这样使用：

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学习网公众号！