本文详解在 Mockito 5.0+ 中使用 MockedStatic 正确验证静态方法调用次数的方法，指出常见错误原因（如未在被测代码中实际触发静态调用），并提供可运行的完整测试示例与关键注意事项。
本文详解在 mockito 5.0+ 中使用 `mockedstatic` 正确验证静态方法调用次数的方法，指出常见错误原因（如未在被测代码中实际触发静态调用），并提供可运行的完整测试示例与关键注意事项。
在单元测试中验证静态方法是否被调用一次，是许多 Java 开发者遇到的经典难题。自 Mockito 3.4.0 起，原生支持通过 MockedStatic<T> 模拟和验证静态方法（无需引入 PowerMock），但其行为与普通 mock 有本质区别：它仅能捕获在 MockedStatic 作用域内、且由被测代码实际执行的静态调用。你遇到的 Wanted but not invoked 错误，根本原因并非语法错误，而是 AvailableOptions.calculateAmount(...) 在 service.generateCancelOrder(...) 执行过程中根本未被调用——或者调用发生在 MockedStatic 作用域之外。
✅ 正确做法：确保静态调用发生在 MockedStatic 作用域内
首先，确认 CancelOrderService.generateCancelOrder() 方法内部确实调用了 AvailableOptions.calculateAmount(...)。若该调用被条件逻辑跳过、或发生在其他类/线程中，verify() 必然失败。假设业务逻辑正确，以下是修复后的标准写法：
@Test
public void generateCancelOrder_callsCalculateAmountOnce() {
// 给定：准备输入与依赖
CurrentOrderState currentState = currentOrderState(ORDER_REF);
TransactionData transactionData = transactionData();
ContractDetails contractDetails = contractDetails();
Source source = source();
// 当：执行被测方法（此时需确保其内部会调用 AvailableOptions.calculateAmount）
try (MockedStatic<AvailableOptions> mockedStatic = Mockito.mockStatic(AvailableOptions.class)) {
// 1. 可选：设定静态方法返回值（增强可测性）
mockedStatic.when(() -> AvailableOptions.calculateAmount(any(AvailableOptions.class)))
.thenReturn("100.00");
// 2. 执行被测方法 —— 关键！静态调用必须在此处发生
service.generateCancelOrder(currentState, source, transactionData, contractDetails);
// 3. 验证：静态方法被调用且仅一次
mockedStatic.verify(
() -> AvailableOptions.calculateAmount(any(AvailableOptions.class)),
times(1)
);
} // ← MockedStatic 自动关闭，确保验证生效
}⚠️ 关键注意事项
- 作用域严格性：MockedStatic 的 verify() 仅统计其 try-with-resources 块内发生的调用。将 service.generateCancelOrder(...) 移到 try 外会导致验证失效。
- 方法签名一致性：verify() 中的 lambda 必须与实际调用的静态方法完全匹配（包括参数类型、数量）。例如，若实际调用为 calculateAmount(builder.build())，则 any(AvailableOptions.class) 是正确的；若传入 null 或其他类型，需调整匹配器。
- 不要重复 mock 同一静态类：一个测试中多次创建 MockedStatic<AvailableOptions> 会导致行为不可预测，应复用同一实例（如上例）。
- 避免“先 verify 后执行”：你的原始代码中 verify(...) 写在 service.generateCancelOrder(...) 之前，这必然失败——调用尚未发生。
-
兼容性要求：确保使用 Mockito ≥ 3.4.0（推荐 ≥ 5.0.0），并在 pom.xml 中添加 JVM 参数（JUnit 5）：
<plugin> <groupId>org.apache.maven.plugins</groupId> <artifactId>maven-surefire-plugin</artifactId> <configuration> <argLine>--add-opens java.base/java.lang=ALL-UNNAMED</argLine> </configuration> </plugin>
? 调试建议
若仍验证失败，请在 AvailableOptions.calculateAmount 方法首行添加断点或日志，确认：
- 该方法是否真的被执行；
- 执行时是否处于 MockedStatic 的 try 块生命周期内；
- 调用参数是否符合 verify() 中的匹配器预期。
遵循以上规范，即可稳定、可靠地验证静态方法调用次数，无需引入 PowerMock 等额外框架，保持测试简洁与可维护性。
