本文详解在 Mockito 2.4.0 及以上版本中，如何通过 MockedStatic 安全、可靠地验证静态方法（如 AvailableOptions.calculateAmount()）是否被精确调用一次，并指出常见错误原因与最佳实践。
本文详解在 mockito 2.4.0 及以上版本中，如何通过 `mockedstatic` 安全、可靠地验证静态方法（如 `availableoptions.calculateamount()`）是否被精确调用一次，并指出常见错误原因与最佳实践。
在单元测试中验证静态方法调用次数，是许多 Java 开发者遇到的典型挑战。从 Mockito 3.4.0 起（实际自 2.4.0 版本已初步支持，3.4.0 后趋于稳定），官方原生支持 MockedStatic API，无需引入 PowerMock 或 PowerMockito —— 这不仅消除了类加载器冲突风险，也显著提升了测试可维护性与兼容性（尤其在 JDK 9+ 和模块化项目中）。
但关键在于：MockedStatic 的作用域必须覆盖被测代码对静态方法的实际调用点。您当前测试失败的根本原因是——您在 service.generateCancelOrder(...) 执行之后才创建 MockedStatic 并设置 stub，而此时 calculateAmount() 已在被测方法内部被调用完毕（甚至可能根本未触发），导致 verify 失败。
✅ 正确做法是：在调用被测方法前启用 MockedStatic，并在其作用域内完成 stub + verify。以下是重构后的推荐写法：
@Test
public void service_called_and_static_method_invoked_once() {
// 准备测试数据（保持原有 setup 逻辑）
CurrentOrderState currentState = currentOrderState(ORDER_REF);
TransactionData transactionData = transactionData();
ContractDetails contractDetails = contractDetails();
Source source = source();
// ✅ 关键：在调用 generateCancelOrder 前开启 MockedStatic 作用域
try (MockedStatic<AvailableOptions> mocked = Mockito.mockStatic(AvailableOptions.class)) {
// 设置期望行为：当 calculateAmount 被任意 AvailableOptions 实例调用时返回空字符串
mocked.when(() -> AvailableOptions.calculateAmount(any(AvailableOptions.class)))
.thenReturn("");
// ✅ 执行被测方法 —— 此时静态调用将被拦截并计数
service.generateCancelOrder(currentState, source, transactionData, contractDetails);
// ✅ 验证：calculateAmount 确实被调用且仅一次
mocked.verify(() -> AvailableOptions.calculateAmount(any(AvailableOptions.class)), times(1));
// 同时验证其他依赖行为（如非静态 mock）
verify(cancelOrderService, times(1)).requestCancelOrder(any(IContext.class));
verifyNoMoreInteractions(cancelOrderService);
} // ← MockedStatic 自动关闭，确保资源释放与作用域隔离
}⚠️ 重要注意事项：
- MockedStatic 是有状态的、非线程安全的，必须严格使用 try-with-resources 确保及时关闭；
- mocked.when(...) 必须在 service.generateCancelOrder(...) 之前声明，否则无法拦截调用；
- verify 中的 lambda 表达式需与 when 中完全一致（包括方法签名和参数匹配器），否则验证会静默失败；
- 若 calculateAmount 在被测路径中未被执行（例如因条件分支跳过），verify(..., times(1)) 将抛出 Wanted but not invoked 异常——此时应先检查业务逻辑覆盖率，而非盲目调整测试；
- 不要混用 mockStatic 与 PowerMockito，二者存在类加载冲突，现代项目应统一采用 MockedStatic。
? 进阶建议：
若 AvailableOptions.calculateAmount() 逻辑复杂或副作用敏感，更佳的设计是将其封装为可注入的策略接口（如 AmountCalculator），通过依赖注入替代静态调用——这不仅能提升可测性，也符合面向对象设计原则。静态方法虽便捷，但过度使用会显著增加测试与重构成本。
综上，正确使用 MockedStatic 不仅能解决“静态方法调用验证”问题，更是迈向高可测性代码的重要一步。
