Java Mockito测试中CompletableFutures偶发返回非预期结果问题

偶发失败的常见原因及解决方案 #

1. 异步竞态条件（最高概率） #

你当前直接调用isCompletedExceptionally()判断状态时，unitUnderTest.invokeMethod()内部的异步逻辑可能还没执行到mockIntegrationA.callRestMethod的调用步骤，此时Future还处于未完成状态，isCompletedExceptionally()会直接返回false，触发断言失败。
这种情况属于典型的竞态条件，只有当线程调度延迟刚好高于你断言执行的时间时才会触发，所以会出现几千次运行才失败一次的现象。
修复方案：不要直接判断瞬时状态，主动等待Future完成后再校验，修改断言逻辑为：

// 等待最长1秒确保异步逻辑执行完成
assertThrows(ExecutionException.class, () -> result.get(1, TimeUnit.SECONDS));

2. Mock桩行为和实际逻辑不匹配 #

你当前给callRestMethod配置的桩是方法调用时直接抛出异常，如果invokeMethod内部捕获了调用callRestMethod时抛出的异常，并且返回了正常完成的CompletableFuture，就会导致断言失败。
如果你的业务逻辑中callRestMethod本身不会抛异常，而是返回一个异常完成的CompletableFuture，那你需要修改Mock桩的配置：

when(mockIntegrationA.callRestMethod(any()))
    .thenReturn(CompletableFuture.failedFuture(new RuntimeException("")))
    .thenReturn(CompletableFuture.completedFuture(null));

3. 测试间状态污染 #

• 如果你开启了测试并行执行，不同测试用例会共享Mock实例，可能会出现其他测试修改了mockIntegrationA的桩配置，导致首次调用没有按预期抛出异常
• 如果MyHandler内部有本地缓存、静态变量或者共享线程池，前一次测试的残留结果或未完成的任务会影响本次测试的执行，需要在@AfterEach中添加清理逻辑，清空缓存、关闭空闲线程。

4. Mock初始化逻辑冗余 #

你同时使用@Mock/@InjectMocks注解和手动调用MockitoAnnotations.openMocks(this)，如果你的测试类已经加了@ExtendWith(MockitoExtension.class)注解，重复的初始化操作可能会导致Mock桩偶发没有生效，你可以去掉@BeforeEach中的手动初始化逻辑验证是否解决问题。

内容的提问来源于stack exchange，提问作者David S