JUnit5

1. JUnit 5 概述#

JUnit 是 Java 生态使用最广的单元测试框架。当前主线是 JUnit 5（Jupiter 编程 模型），2025-09-30 团队又发布了 JUnit 6.0：Platform/Jupiter/Vintage 统一为 单一版本号、基线提升到 Java 17（Kotlin 2.2），注解与编程模型和 5.x 基本兼容， 存量代码升级成本很低；仍在 Java 8 上运行的老项目可继续使用 5.x 系列。本文 内容对 5.x 与 6.x 均适用。

前置知识：Java 基础语法、Maven 或 Gradle 的基本使用、面向对象常识。

1.1 架构#

1.2 Maven 依赖#

<!-- JUnit 6：三模块统一版本号，要求 Java 17+ -->
<dependency>
    <groupId>org.junit.jupiter</groupId>
    <artifactId>junit-jupiter</artifactId>
    <version>6.0.0</version>
    <scope>test</scope>
</dependency>

<!-- Java 8 项目请沿用 5.x 系列（如 5.10.2），API 与本文一致 -->

2. 常用注解#

3. 断言#

3.1 标准断言#

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

@Test
void testAssertions() {
    assertEquals(4, 2 + 2);
    assertNotEquals(5, 2 + 2);
    assertTrue(4 > 3);
    assertFalse(4 < 3);
    assertNull(null);
    assertNotNull(new Object());
    assertThrows(ArithmeticException.class, () -> {
        int result = 1 / 0;
    });
}

3.2 分组断言#

@Test
void testGroupedAssertions() {
    assertAll("person",
        () -> assertEquals("Alice", person.getName()),
        () -> assertEquals(25, person.getAge()),
        () -> assertEquals("alice@example.com", person.getEmail())
    );
}

3.3 超时断言#

@Test
void testTimeout() {
    assertTimeout(Duration.ofMillis(500), () -> {
        Thread.sleep(200);
    });
}

4. 生命周期#

class LifecycleTest {

    @BeforeAll
    static void setupAll() {
        System.out.println("Before all tests");
    }

    @BeforeEach
    void setup() {
        System.out.println("Before each test");
    }

    @Test
    void test1() {
        System.out.println("Test 1");
    }

    @Test
    void test2() {
        System.out.println("Test 2");
    }

    @AfterEach
    void teardown() {
        System.out.println("After each test");
    }

    @AfterAll
    static void teardownAll() {
        System.out.println("After all tests");
    }
}

5. 参数化测试#

5.1 基本参数化#

@ParameterizedTest
@ValueSource(ints = {1, 2, 3, 4, 5})
void testPositive(int number) {
    assertTrue(number > 0);
}

@ParameterizedTest
@ValueSource(strings = {"hello", "world", "junit"})
void testNonEmpty(String str) {
    assertFalse(str.isEmpty());
}

5.2 参数来源#

5.3 CSV 参数化#

@ParameterizedTest
@CsvSource({
    "1, 1, 2",
    "2, 3, 5",
    "-1, 1, 0",
    "0, 0, 0"
})
void testAdd(int a, int b, int expected) {
    assertEquals(expected, Calculator.add(a, b));
}

5.4 MethodSource#

@ParameterizedTest
@MethodSource("provideTestData")
void testWithMethodSource(String input, int expected) {
    assertEquals(expected, input.length());
}

static Stream<Arguments> provideTestData() {
    return Stream.of(
        Arguments.of("hello", 5),
        Arguments.of("world", 5),
        Arguments.of("", 0)
    );
}

6. 嵌套测试#

@DisplayName("Stack tests")
class StackTest {

    Stack<String> stack;

    @BeforeEach
    void createStack() {
        stack = new Stack<>();
    }

    @Nested
    @DisplayName("when new")
    class WhenNew {

        @Test
        @DisplayName("is empty")
        void isEmpty() {
            assertTrue(stack.isEmpty());
        }

        @Nested
        @DisplayName("after pushing")
        class AfterPushing {

            @BeforeEach
            void pushElement() {
                stack.push("element");
            }

            @Test
            @DisplayName("is not empty")
            void isNotEmpty() {
                assertFalse(stack.isEmpty());
            }
        }
    }
}

7. 扩展模型#

7.1 自定义扩展#

public class LoggingExtension implements BeforeEachCallback, AfterEachCallback {
    @Override
    public void beforeEach(ExtensionContext context) {
        System.out.println("Before: " + context.getDisplayName());
    }

    @Override
    public void afterEach(ExtensionContext context) {
        System.out.println("After: " + context.getDisplayName());
    }
}

@ExtendWith(LoggingExtension.class)
class MyTest {
    @Test
    void test() { }
}

7.2 常用扩展#

8. 常见陷阱#

9. 最佳实践#

小结#

• 初学者要点：先掌握 @Test 与生命周期五件套、Assertions 常用断言、 @ParameterizedTest 三种常用来源（@ValueSource、@CsvSource、 @MethodSource），就能覆盖绝大多数单元测试场景。
• 进阶注意：assertAll 用于聚合断言、扩展模型（@ExtendWith）是与 Spring/Mockito 集成的统一入口；新项目在 Java 17+ 上直接选 JUnit 6， 存量 Java 8 项目留在 5.x，二者编程模型一致。