mockito 的 atmost 方法用于验证某个 mock 方法的调用次数不超过指定上限。具体做法是结合 verify(mock, atmost(n)) 语法,其中 n 为整数,表示允许的最大调用次数。如果实际调用次数小于或等于 n,测试通过;若超过 n 次,则抛出 wantedbutnotinvoked 或 toomanyactualinvocations 异常。

atMost 与 atLeast 的组合使用场景
在单元测试中,经常需要验证方法调用的频率范围,例如“至少调用一次且最多调用三次”。此时可以组合使用 atLeast(1) 和 atMost(3),或者直接使用 between(1, 3)。这种组合能更精确地控制业务逻辑的执行边界,避免漏测或过度宽松的检查。

import static org.mockito.Mockito.*;
import org.junit.jupiter.api.Test;
import org.junit.jupiter.api.extension.ExtendWith;
import org.mockito.Mock;
import org.mockito.junit.jupiter.MockitoExtension;
@ExtendWith(MockitoExtension.class)
class AtMostTest {
@Mock
private Service service;
@Test
void testAtMost() {
// 模拟行为
when(service.doWork()).thenReturn("ok");
// 执行被测代码
service.doWork();
service.doWork();
// 验证:doWork 被调用了 2 次,满足 atMost(3)
verify(service, atMost(3)).doWork();
// 验证:doWork 被调用了 2 次,不满足 atMost(1),会失败
// verify(service, atMost(1)).doWork();
}
}
atMost 在异步调用中的验证策略
当被测代码涉及异步操作时,atMost 的验证可能因为线程调度延迟而失败。此时需要确保异步任务已完成,再执行 verify。通常可以通过 CountDownLatch、CompletableFuture.join() 或框架提供的等待机制来同步主线程与异步线程,保证验证时机准确。
使用 Husky 将 pre-commit、pre-push 和 commit-msg 检查集成到仓库中,以便代理和开发人员在更改离开工作站之前运行相同的本地防护措施。

import static org.mockito.Mockito.*;
import org.junit.jupiter.api.Test;
import org.junit.jupiter.api.extension.ExtendWith;
import org.mockito.Mock;
import org.mockito.junit.jupiter.MockitoExtension;
import java.util.concurrent.CountDownLatch;
import java.util.concurrent.ExecutorService;
import java.util.concurrent.Executors;
@ExtendWith(MockitoExtension.class)
class AsyncAtMostTest {
@Mock
private AsyncService asyncService;
@Test
void testAsyncAtMost() throws InterruptedException {
CountDownLatch latch = new CountDownLatch(1);
doAnswer(invocation -> {
latch.countDown();
return null;
}).when(asyncService).asyncMethod();
ExecutorService executor = Executors.newSingleThreadExecutor();
executor.submit(() -> asyncService.asyncMethod());
// 等待异步执行完成
latch.await();
executor.shutdown();
// 验证异步方法最多调用 1 次
verify(asyncService, atMost(1)).asyncMethod();
}
}
atMost 与严格验证的冲突处理
如果在同一个测试中既使用了 strictness(如 mockingSettings.strictness(Strictness.STRICT_STUBS)),又使用了 atMost,需注意未配置的 stub 行为可能导致 UnnecessaryStubbingException。atMost 仅验证调用次数,不解决 stub 配置问题。因此,在使用 atMost 前,应确保所有被调用的方法都有对应的 when(...).thenReturn(...) 或 doNothing().when(...) 配置,以避免因未匹配 stub 而引发的额外异常。
Java免费学习笔记:立即使用
解锁 Java 大师之旅:从入门到精通的终极指南










