如何使用JUnit 5和Spring Boot覆盖assertThrows内部方法的代码覆盖率

架构老林

2026-10-6

JUnit 5 assertThrows 内部调用覆盖率缺失解决方案

根因

主流Java代码覆盖率工具（最常见为JaCoCo）低于0.8.8版本时，和JUnit 5 assertThrows 传入的lambda执行逻辑存在兼容问题：lambda内部的方法调用会被JUnit的代理封装，旧版本JaCoCo无法识别该部分字节码的执行链路，因此判定为未覆盖。

修复方案

优先升级JaCoCo到0.8.8及以上稳定版本，该版本已官方修复JUnit 5 lambda场景的覆盖率统计缺陷

Maven配置修改示例：

<build>
  <plugins>
    <plugin>
      <groupId>org.jacoco</groupId>
      <artifactId>jacoco-maven-plugin</artifactId>
      <version>0.8.12</version> <!-- 可替换为官方最新稳定版 -->
      <executions>
        <execution>
          <goals>
            <goal>prepare-agent</goal>
            <goal>report</goal>
          </goals>
        </execution>
      </executions>
    </plugin>
  </plugins>
</build>

Gradle配置修改示例：

plugins {
  id 'jacoco'
}

jacoco {
  toolVersion = "0.8.12"
}

test {
  jacoco {
    enabled = true
  }
}

若暂时无法升级JaCoCo，可将assertThrows的lambda写法替换为传统try-catch写法，手动捕获异常后做断言，即可正常统计方法调用覆盖率：
原测试写法：

@Test
void testAddUserInvalidParam() {
  User invalidUser = new User();
  assertThrows(IllegalArgumentException.class, () -> userService.addUser(invalidUser));
}

改写后写法：

@Test
void testAddUserInvalidParam() {
  User invalidUser = new User();
  IllegalArgumentException caughtEx = null;
  try {
    userService.addUser(invalidUser);
  } catch (IllegalArgumentException e) {
    caughtEx = e;
  }
  // 异常断言
  assertNotNull(caughtEx);
  assertEquals("用户参数不能为空", caughtEx.getMessage());
}