JUnit 5 测试 void 方法的正确实践：验证异常与行为覆盖_网络技术

本文详解如何对返回 void 的 spring service 方法进行有效单元测试，重点讲解使用 junit 5 的 `assertdoesnotthrow` 和 `assertthrows` 验证不同响应状态下的异常抛出逻辑，避免误用 mockito spy/mock 导致测试失效。

在单元测试中，针对 void 返回类型的方法（如 checkVaultResponseErrors），核心目标不是“调用它”，而是验证其副作用行为——即是否按预期抛出特定异常、是否静默执行成功，或是否触发了依赖组件的交互。错误地对被测方法本身使用 Mockito.spy() 并 doThrow()/doNothing()，实质上是绕过了真实逻辑，导致零代码覆盖率和无效测试。

正确的做法是：保持方法真实执行，仅对它的依赖（如 ProductRepository 或 DatabaseService）进行必要模拟；然后通过断言其运行时行为来验证逻辑。

以下是针对 checkVaultResponseErrors 的三个关键测试用例，覆盖全部分支：

✅ 场景 1：ResponseStatus.SUCCESS —— 应静默执行，不抛异常

@Test
void checkVaultResponseErrors_whenSuccess_thenNoException() {
    // Given
    VaultResponse vaultResponse = new VaultResponse();
    vaultResponse.setResponseStatus(ResponseStatus.SUCCESS);
    vaultResponse.setErrors(Collections.emptyList()); // 空错误列表

    // When & Then
    assertDoesNotThrow(() -> vaultService.checkVaultResponseErrors(vaultResponse));
}

✅ 场景 2：ResponseStatus.EXCEPTION —— 应抛出 VaultException

@Test
void checkVaultResponseErrors_whenExceptionStatus_thenThrowsVaultException() {
    // Given
    Error error = new Error("Vault connection timeout");
    VaultResponse vaultResponse = new VaultResponse();
    vaultResponse.setResponseStatus(ResponseStatus.EXCEPTION);
    vaultResponse.setErrors(Collections.singletonList(error));

    // When & Then
    VaultException thrown = assertThrows(VaultException.class,
        () -> vaultService.checkVaultResponseErrors(vaultResponse));

    // 可选：验证异常消息
    assertEquals("Vault connection timeout", thrown.getMessage());
}

✅ 场景 3：ResponseStatus.FAILURE —— 应抛出 VaultFailure

@Test
void checkVaultResponseErrors_whenFailureStatus_thenThrowsVaultFailure() {
    // Given
    Error error = new Error("Invalid token format");
    VaultResponse vaultResponse = new VaultResponse();
    vaultResponse.setResponseStatus(ResponseStatus.FAILURE);
    vaultResponse.setErrors(Collections.singletonList(error));

    // When & Then
    VaultFailure thrown = assertThrows(VaultFailure.class,
        () -> vaultService.checkVaultResponseErrors(vaultResponse));

    assertEquals("Invalid token format", thrown.getMessage());
}

⚠️ 重要注意事项：不要 mock/spy 被测方法本身：doThrow(...).when(spy).method() 会跳过真实逻辑，导致 if 分支完全未执行，无法覆盖；确保 VaultResponse.errors 非 null：虽然 @JsonInclude(NON_NULL) 影响序列化，但测试中应显式初始化 errors 列表（如用 Collections.emptyList()），避免 NullPointerException 干扰测试意图；依赖注入需完整：vaultService 实例应通过 @Autowired 获取（推荐使用 @SpringBootTest 或 @ExtendWith(MockitoExtension.class) + 手动构造），确保 repository 和 databaseService 已正确注入（若无需它们参与逻辑，可用 Mockito.mock() 替代）；避免冗余 verify：该方法无外部交互（未调用 repository 或 databaseService），因此 Mockito.verify() 不适用；若后续逻辑扩展了依赖调用，再针对性验证。

通过以上三类测试，可实现 100% 分支覆盖（SUCCESS / EXCEPTION / FAILURE），且每个测试语义清晰、失败原因明确，真正体现 TDD 中“测试驱动行为”的本质。

# js # json # ai # springboot # red # spring # junit # NULL # if # void # class # tdd # 抛出 # 推荐使用 # 可选 # 若无 # 三类 # 跳过 # 实质上 # 不适用 # 中应 # 如用

相关栏目：【网站优化151355 】【网络推广146373 】【网络技术251813 】【 AI营销90571 】