`times(1)`要求目标方法**必须被调用恰好一次**，而`atmostonce()`允许调用**零次或一次**，二者语义严格不同，直接影响测试的严谨性和失败场景。
在 Mockito 的 verify() 验证中，times(1) 和 atMostOnce()（等价于 atMost(1)）虽常被误认为功能相同，但其行为语义和校验逻辑存在本质差异：
✅ times(1) 表示精确匹配：被验证的方法必须被调用且仅被调用一次。若未被调用（0次）或被调用多次（2+次），测试均会立即失败，抛出 VerificationInOrderFailure 或 TooManyActualInvocations 等异常。
✅ atMostOnce() 表示上限约束：被验证的方法最多调用一次，即接受 0 次或 1 次 调用。只有当调用次数 ≥ 2 时才会失败；0 次调用完全合法，不会导致验证失败。
下面通过代码示例直观说明差异：
// 假设 calculatorService 是一个 mock 对象 CalculatorService calculatorService = mock(CalculatorService.class); // 场景1：add() 实际未被调用 // verify(calculatorService, times(1)).add(10.0, 20.0); // ❌ 失败：Wanted 1 time, but was 0 verify(calculatorService, atMostOnce()).add(10.0, 20.0); // ✅ 通过（0次符合“≤1”） // 场景2：add() 被调用两次 calculatorService.add(10.0, 20.0); calculatorService.add(10.0, 20.0); // verify(calculatorService, times(1)).add(10.0, 20.0); // ❌ 失败：Wanted 1 time, but was 2 // verify(calculatorService, atMostOnce()).add(10.0, 20.0); // ❌ 失败：Wanted at most 1 time, but was 2 // 场景3：add() 被调用一次 → 两者均通过 calculatorService.add(10.0, 20.0); verify(calculatorService, times(1)).add(10.0, 20.0); // ✅ verify(calculatorService, atMostOnce()).add(10.0, 20.0); // ✅
⚠️ 注意事项：
- atMostOnce() 常用于可选行为的验证，例如日志记录、异步通知、缓存刷新等非核心路径逻辑，其执行与否不影响主流程正确性；
- times(1) 则适用于关键契约行为，如服务调用、状态变更、事务提交等必须发生的操作，体现“强保证”；
- 不要因“当前测试通过”而混淆二者——它们代表不同的业务意图和契约强度；
- atMostOnce() 内部由 Mockito 的 AtMost 验证器实现，检查 actualInvocations.size() <= maxCount；而 times(1) 使用 Exact 验证器，强制 actualInvocations.size() == count。
总结：选择哪个验证器，不应取决于“是否容易通过”，而应基于被测行为的语义承诺。精准使用 times(n)、atLeastOnce()、atMost(n) 等验证器，是编写可维护、高信噪比单元测试的关键实践。
