本文详解如何对返回 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 中“测试驱动行为”的本质。
