jacoco统计异常分支覆盖需测试真实抛出并执行对应路径代码，包括catch、finally及异常前校验逻辑；空catch、default分支、lombok生成代码等易误红，须通过assertthrows+副作用验证或分路径测试确保覆盖。
Java 单元测试要真正覆盖异常分支，不能只靠“代码执行了”就算数——JaCoCo 统计的是字节码执行路径，而异常分支是否被覆盖，取决于测试是否实际抛出并捕获了对应异常，且该异常路径上的代码行被 JVM 执行到。
异常分支被覆盖的关键条件
JaCoCo 将 catch 块、finally 中的语句、以及抛出异常前的校验逻辑（如 if (obj == null) throw new NullPointerException()）都视为独立可覆盖的分支。要让这些变绿，必须满足：
- 测试触发了异常产生的前置条件（例如传
null、负数、空集合、越界索引等） - 异常确实被抛出（未被意外吞掉或提前 return）
- 如果用了
try-catch，则catch块内的代码必须执行；若没 catch，则调用栈需完整展开至测试方法外（此时 JaCoCo 仍能标记抛出点和上层处理逻辑） -
finally块无论是否异常都会执行，但 JaCoCo 要求它“被运行到”，所以即使正常流程也要进一次，异常流程再进一次，才算双路径覆盖
JUnit 5 正确写法：assertThrows + 验证行为
仅用 assertThrows 只能证明异常发生了，但无法确保 catch 或清理逻辑被执行。推荐组合验证：
Alibabacloud Sdk Client Initialization For Java
下载
在 Java 中初始化和管理阿里云 SDK客户端。包括单例模式、线程安全、endpoint 与 region 配置、VPC 终端节点、同步与异步等。
- 用
assertThrows确认异常类型和消息 - 在
catch块中添加可观察副作用（如设标志位、记录日志、修改状态），再在测试中检查该副作用 - 对含
finally的方法，分别写两个测试：一个走正常流，一个走异常流，确保 finally 内每行都被执行
示例：
@Test
void shouldThrowWhenIdIsNull() {
// 触发空指针校验逻辑（可能在方法开头）
IllegalArgumentException ex = assertThrows(IllegalArgumentException.class, () -> service.process(null));
assertEquals("id must not be null", ex.getMessage());
}
@Test
void shouldRollbackAndLogOnFailure() {
// 模拟底层服务抛异常
when(repo.save(any())).thenThrow(new RuntimeException("DB fail"));
String result = service.processWithCleanup("valid-id"); // 方法内有 try-catch-finally
// 验证 catch 中的日志/回滚行为（如通过 Mockito verify）
verify(logger).error(eq("Process failed"), any(RuntimeException.class));
verify(repo).rollback(); // 假设有 rollback 方法被调用
}
JaCoCo 对异常相关结构的常见“误红”与应对
以下情况显示为未覆盖，并非测试遗漏，而是 JaCoCo 的统计机制限制：
-
空的
catch块：即使逻辑上一定会进，JaCoCo 仍要求该块至少执行一次（需真实触发异常） -
default分支在switch中：即使所有case都测了，default行仍标红，除非显式构造进入 default 的输入 -
Lombok 生成的空构造/Getter：字节码存在但无源码映射，JaCoCo 跳过，建议在插件配置中
<excludes></excludes>过滤**/Lombok*类 - 编译器插入的桥接方法或 lambda 匿名类：JaCoCo 8.7+ 已较好支持，旧版本建议升级
验证异常覆盖率是否真实生效
别只看 HTML 报告里“branch coverage 85%”——重点检查报告中标红的异常相关行：
- 打开
target/site/jacoco/index.html→ 找到被测方法 → 查看每行右侧的菱形图标 - 红色菱形表示该分支（如
if的 false 路径、catch块）完全未执行 - 点击红色行，看 JaCoCo 是否提示 “0 of 2 branches covered” —— 这说明有两个分支（true/false 或 try/catch），目前只走了1个
- 补一个触发异常的测试后，重新运行
mvn clean test jacoco:report，刷新页面确认变绿
Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
