Mockito静态Mock已注册报错排查：修改被测类后异常

修改被测类ConsumerKafkaCardReplacementService后，测试出现大量如下错误：

ConsumerKafkaCardReplacementServiceTest > processCardReplacementSuccessfulWithCIDCredit FAILED
    org.mockito.exceptions.base.MockitoException: 
    For com.api.loyalty.event.listener.global.RewardsProductConfigService, static mocking is already registered in the current thread

    To create a new mock, the existing static mock registration must be deregistered
        at com.api.loyalty.event.listener.service.ConsumerKafkaCardReplacementServiceTest.processCardReplacementSuccessfulWithCIDCredit(ConsumerKafkaCardReplacementServiceTest.java:308)

每个测试方法中，静态Mock都会在末尾关闭：

service = Mockito.mockStatic(RewardsProductConfigService.class);  // (line 308)
service.when(() -> RewardsProductConfigService.queryRewardsProductConfigMap(Mockito.any(), Mockito.any())).thenReturn(Optional.of(TestUtil.getCSSSCProductDetails()));   
...

service.close();

未修改RewardsProductConfigService类、queryRewardsProductConfigMap方法、TestUtil类及getCSSSCProductDetails方法，测试类和测试方法也未改动。尝试为测试类添加注解@FixMethodOrder(MethodSorters.NAME_ASCENDING)和@TestMethodOrder(MethodOrderer.MethodName.class)，问题仍存在，请问原因是什么？

核心原因 #

1. 异常打断Mock关闭流程：你修改被测类后，新逻辑可能引入了未捕获的异常，导致测试方法在执行到service.close()之前就终止，静态Mock的资源未被释放。后续测试方法在同一线程中创建同类型静态Mock时，就会触发“已注册”的冲突错误。
2. 线程复用残留注册：JUnit（尤其是结合Spring Test时）会复用测试线程，上一个测试未清理的静态Mock注册会留在线程中，下一个测试执行时直接冲突。

解决办法 #

• 用try-finally强制保证Mock关闭：把关闭逻辑放到finally块里，无论测试是否抛出异常都能执行清理：

MockedStatic<RewardsProductConfigService> service = null;
try {
    service = Mockito.mockStatic(RewardsProductConfigService.class);
    service.when(() -> RewardsProductConfigService.queryRewardsProductConfigMap(Mockito.any(), Mockito.any()))
           .thenReturn(Optional.of(TestUtil.getCSSSCProductDetails()));   
    // 测试逻辑代码
} finally {
    if (service != null) {
        service.close();
    }
}

• 改用注解自动管理Mock生命周期：使用Mockito的@MockedStatic注解配合JUnit扩展，让框架自动处理静态Mock的创建与销毁，避免手动管理的遗漏：

import org.mockito.junit.jupiter.MockitoExtension;
import org.mockito.MockedStatic;
import static org.mockito.Mockito.when;

@ExtendWith(MockitoExtension.class)
public class ConsumerKafkaCardReplacementServiceTest {

    @MockedStatic(RewardsProductConfigService.class)
    private MockedStatic<RewardsProductConfigService> service;

    @Test
    void processCardReplacementSuccessfulWithCIDCredit() {
        when(RewardsProductConfigService.queryRewardsProductConfigMap(Mockito.any(), Mockito.any()))
           .thenReturn(Optional.of(TestUtil.getCSSSCProductDetails()));
        // 测试逻辑
    }
}

• 排查被测类新逻辑的异常：检查修改后的ConsumerKafkaCardReplacementService代码，确认是否新增了会中断测试执行的未捕获异常，确保测试流程能正常走到关闭Mock的步骤。

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