怎么利用JUnit5编写高质量的单元测试与覆盖率统计-java教程-PHP中文网

JUnit5需配置junit-jupiter（含api/engine/params）、Platform和Vintage（兼容JUnit4）；单元测试应避免滥用@SpringBootTest，优先用@ExtendWith(MockitoExtension.class)等轻量注解；JaCoCo低分支覆盖主因是未测if/else、异常路径等。

怎么利用junit5编写高质量的单元测试与覆盖率统计

JUnit5依赖配置必须包含三个核心模块

只加 junit-jupiter-api 是不够的，运行时会报 NoClassDefFoundError: org.junit.platform.launcher.TestExecutionListener。JUnit5 实际由三部分组成：Platform（执行引擎）、Jupiter（编写接口）、Vintage（兼容旧版）。Spring Boot 2.2+ 默认已引入 Platform 和 Jupiter，但显式声明更可控。

推荐 Maven 配置（注意版本对齐）：

<dependency><groupid>org.junit.jupiter</groupid><artifactid>junit-jupiter</artifactid><scope>test</scope></dependency>

这个 junit-jupiter 是 BOM 式聚合包，自动拉取 junit-jupiter-api、junit-jupiter-engine 和 junit-jupiter-params，避免手动配错版本。若项目含 JUnit4 遗留测试，再补一个 junit-vintage-engine 即可。

@SpringBootTest 不是默认选择，多数场景该用 @ExtendWith(MockitoExtension.class)

直接用 @SpringBootTest 启动完整上下文，测试类平均启动耗时 2–5 秒，且容易因 Bean 冲突或配置缺失失败。它只适合验证多组件协同逻辑（如 Controller → Service → Repository 链路），而非单个 Service 方法。

绝大多数单元测试应走轻量路径：

Service 层测试：用 @ExtendWith(MockitoExtension.class) + @Mock / @InjectMocks 模拟依赖，不加载 Spring 容器
Repository 层测试：用 @DataJpaTest（仅加载 JPA 相关 Bean）+ 内存数据库（如 H2）
Controller 层测试：用 @WebMvcTest + @MockBean，跳过 Service 实现

例如一个纯业务逻辑的 OrderService.calculateDiscount()，Mock 掉 PriceRuleRepository 和 UserLevelService 即可，无需 Spring 上下文。

JaCoCo 报告里“行覆盖高但分支覆盖低”说明断言写得有问题

常见现象：JaCoCo 显示某方法行覆盖率 100%，但分支覆盖率只有 40%。典型原因是只测了主路径，没覆盖 if/else、switch case、Optional.isPresent() 等分支逻辑。

检查点：

每个 if (x != null) 必须有 x = null 和 x = new X() 两组输入
使用 @ParameterizedTest + @ValueSource 覆盖枚举值、布尔组合、边界值（如空字符串、负数、Long.MAX_VALUE）
对抛异常路径，必须用 assertThrows(() -> method("invalid"))，不能只写 method("invalid") 后期待失败

示例：一个判断用户等级的方法

@ParameterizedTest
@CsvSource({"GOLD, true", "SILVER, false", "BRONZE, false", "null, false"})
void shouldCheckIfUserIsGold(String level, boolean expected) {
    User user = new User(); 
    user.setLevel(level);
    assertEquals(expected, service.isGoldUser(user));
}