使用mockStatic桩化静态方法无效，如何解决？

问题场景 #

我有一个静态类ResourceUtils，包含如下方法：

static String getVersion(TokenGenerator tokenGenerator, String baseUri) 

在Resource类中调用了该静态方法，在Resource的单元测试中编写了如下代码：

mockStatic(ResourceUtils.class);
when(ResourceUtils.getVersion(any(), any())).thenReturn("api-2021-01");

但调用ResourceUtils.getVersion时始终执行实际方法而非桩逻辑，即使把MockStatic移到@BeforeEach中也无效，需要解决如何让测试触发桩逻辑。

可行解决方案 #

1. 管控MockStatic实例的生命周期 #

MockStatic返回的MockedStatic实例必须在测试全程保持活跃，不能提前被回收。正确的做法是将实例保存为测试类成员，在@BeforeEach中初始化，@AfterEach中关闭：

private MockedStatic<ResourceUtils> resourceUtilsMock;

@BeforeEach
void setUp() {
    // 创建静态Mock并保存实例
    resourceUtilsMock = mockStatic(ResourceUtils.class);
    // 明确指定参数类型进行桩逻辑配置
    resourceUtilsMock.when(() -> ResourceUtils.getVersion(any(TokenGenerator.class), anyString()))
                     .thenReturn("api-2021-01");
}

@AfterEach
void tearDown() {
    // 手动关闭实例，避免影响其他测试
    resourceUtilsMock.close();
}

2. 精准匹配方法参数 #

避免使用无类型的any()，改用与方法参数严格对应的匹配器：比如any(TokenGenerator.class)匹配第一个参数，anyString()匹配第二个字符串参数。参数匹配不精准会导致Mock逻辑不触发，转而执行实际方法。

3. 确认Mockito版本与依赖导入 #

确保使用Mockito 3.4.0及以上版本，旧版本的静态Mock功能存在缺陷。同时检查导入的类是否正确：

import org.mockito.MockedStatic;
import static org.mockito.Mockito.mockStatic;
import static org.mockito.Mockito.any;
import static org.mockito.Mockito.anyString;

4. 保证Mock初始化在实际调用之前 #

如果在mockStatic执行前，测试代码或被测试类已经调用了ResourceUtils.getVersion，那么静态Mock不会生效。必须确保mockStatic的初始化逻辑在所有可能触发该静态方法的代码之前执行。

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