测试覆盖率提升

测试覆盖率提升

提升测试覆盖率是确保代码质量的重要手段，但覆盖率本身并非终极目标，关键在于通过有效测试覆盖核心逻辑和边界条件。Mockito 结合覆盖率工具（如 JaCoCo）可精准定位未覆盖代码，设计针对性测试用例。本章通过典型场景解析提升覆盖率的实用策略。

---

1. 覆盖率分析工具配置

1.1 集成 JaCoCo

在 Maven 项目中添加 JaCoCo 插件：

<plugin>
    <groupId>org.jacoco</groupId>
    <artifactId>jacoco-maven-plugin</artifactId>
    <version>0.8.11</version>
    <executions>
        <execution>
            <goals>
                <goal>prepare-agent</goal>
                <goal>report</goal>
            </goals>
        </execution>
    </executions>
</plugin>

生成报告：

mvn clean test jacoco:report

报告路径：target/site/jacoco/index.html，可视化展示行覆盖率、分支覆盖率等。

1.2 关键指标解读

• 行覆盖率：代码行是否被执行。
• 分支覆盖率：条件语句（如 if/else）是否覆盖所有分支。
• 复杂度覆盖率：高复杂度方法的覆盖情况。

---

2. 核心逻辑覆盖策略

2.1 覆盖条件分支

场景：用户服务根据年龄验证用户类型。

public class UserService {
    public String getUserType(int age) {
        if (age < 0) {
            throw new IllegalArgumentException("Invalid age");
        } else if (age < 18) {
            return "MINOR";
        } else {
            return "ADULT";
        }
    }
}

测试设计：

@Test
void getUserType_ShouldCoverAllBranches() {
    // 分支1: age < 0 → 异常
    assertThrows(IllegalArgumentException.class, () -> userService.getUserType(-1));
    
    // 分支2: 0 ≤ age < 18 → "MINOR"
    assertEquals("MINOR", userService.getUserType(15));
    
    // 分支3: age ≥ 18 → "ADULT"
    assertEquals("ADULT", userService.getUserType(20));
}

覆盖率提升：确保每个 if/else 分支均有测试用例覆盖。

---

3. 异常处理覆盖

3.1 模拟依赖抛出异常

场景：用户注册时数据库访问失败。

public class UserService {
    private final UserDao userDao;
    
    public void register(String username) {
        try {
            userDao.save(new User(username));
        } catch (DataAccessException e) {
            throw new ServiceException("Registration failed", e);
        }
    }
}

测试设计：

@Test
void register_ShouldThrowOnDatabaseFailure() {
    // 模拟数据库异常
    doThrow(DataAccessException.class).when(mockUserDao).save(any());
    
    // 验证自定义异常
    assertThrows(ServiceException.class, () -> userService.register("alice"));
}

覆盖率提升：覆盖 catch 代码块。

---

4. 边界条件覆盖

4.1 参数化测试

场景：计算折扣率，根据订单金额不同返回不同折扣。

public class DiscountService {
    public double calculateDiscount(double amount) {
        if (amount <= 0) throw new IllegalArgumentException();
        if (amount < 100) return 0.0;
        if (amount < 500) return 0.1;
        return 0.2;
    }
}

参数化测试设计：

@ParameterizedTest
@CsvSource({
    "0.0, IllegalArgumentException.class",
    "50.0, 0.0",
    "200.0, 0.1",
    "600.0, 0.2"
})
void calculateDiscount_ShouldCoverBoundaries(double amount, Object expected) {
    if (expected instanceof Class) {
        assertThrows((Class<? extends Throwable>) expected, 
            () -> discountService.calculateDiscount(amount));
    } else {
        assertEquals((Double) expected, discountService.calculateDiscount(amount));
    }
}

覆盖率提升：覆盖所有金额区间和异常输入。

---

5. 复杂对象行为覆盖

5.1 集合与链式调用

场景：批量处理订单，验证集合操作。

public class OrderService {
    public List<Order> filterActiveOrders(List<Order> orders) {
        return orders.stream()
            .filter(Order::isActive)
            .collect(Collectors.toList());
    }
}

测试设计：

@Test
void filterActiveOrders_ShouldHandleEmptyList() {
    // 空列表场景
    assertTrue(orderService.filterActiveOrders(emptyList()).isEmpty());
}

@Test
void filterActiveOrders_ShouldFilterInactive() {
    // 混合状态订单
    List<Order> orders = Arrays.asList(
        new Order(true), 
        new Order(false), 
        new Order(true)
    );
    List<Order> result = orderService.filterActiveOrders(orders);
    assertEquals(2, result.size());
}

覆盖率提升：覆盖集合遍历和流式处理逻辑。

---

6. 依赖交互覆盖率

6.1 验证 Mock 对象调用参数

场景：邮件服务发送带特定内容的邮件。

public class NotificationService {
    private final EmailClient emailClient;
    
    public void sendWelcomeEmail(String email) {
        emailClient.send(new EmailRequest(
            email, 
            "Welcome", 
            "Welcome to our platform!"
        ));
    }
}

测试设计：

@Test
void sendWelcomeEmail_ShouldCaptureEmailContent() {
    notificationService.sendWelcomeEmail("user@test.com");
    
    ArgumentCaptor<EmailRequest> captor = ArgumentCaptor.forClass(EmailRequest.class);
    verify(mockEmailClient).send(captor.capture());
    
    EmailRequest request = captor.getValue();
    assertEquals("user@test.com", request.getTo());
    assertTrue(request.getBody().contains("Welcome"));
}

覆盖率提升：验证参数内容和格式，覆盖对象构造逻辑。

---

7. 覆盖率陷阱与规避

陷阱	解决方案
覆盖但未断言	确保每个测试包含有效断言，避免“假通过”
过度追求100%覆盖率	聚焦核心逻辑，忽略Getter/Setter等简单代码
未覆盖异常恢复逻辑	模拟依赖异常，验证恢复流程
静态方法未覆盖	结合 PowerMock 或重构为实例方法

---

总结

提升测试覆盖率的本质是系统性设计用例，而非盲目追求数字。通过：

1. 分析覆盖率报告：定位未覆盖代码。
2. 设计场景化测试：覆盖边界、异常、分支。
3. 结合 Mockito 精准模拟：控制依赖行为。
4. 参数化与数据驱动：批量验证输入组合。
   可构建高覆盖、高可信度的测试套件，为代码质量提供坚实保障。