Mockito MockedStatic无法Mock静态Util.parse方法问题求助

问题描述 #

使用Mockito 3.4.4版本的MockedStatic对静态工具类Util的parse(String, Class)方法进行Mock，运行时Mock未生效，控制台打印NULL，预期应返回预先加载的mock.json文件中的Swagger对象。

业务代码 #

public List<ServiceRecord> getListServices(Services.Type type, String env) throws Exception {
    Swagger swagger2 = Util.parse("{ss}", Swagger.class);
    System.out.println(swagger2);
    // 后续业务逻辑...
}

测试类代码 #

@RunWith(MockitoJUnitRunner.class)
public class RemoteServicesTest {
    // 依赖注入或初始化remoteCloudLegacyServices、environment...
    
    @Test
    public void getListServicesLegacyTest() throws Exception {
        Swagger swaggerMock = IoUtil.readFromFile("mock.json", Swagger.class);
        
        try(MockedStatic<Util> mockUtil2 = Mockito.mockStatic(Util.class)) {
            mockUtil2.when(() -> Util.parse(eq("{ss}"), eq(Swagger.class))).thenReturn(swaggerMock);
            List<ServiceRecord> serviceRecordList2 = remoteCloudLegacyServices.getListServices(Services.Type.LEGACY, environment.getEnv());
        }
    }
}

依赖配置 #

<dependency>
    <groupId>org.mockito</groupId>
    <artifactId>mockito-inline</artifactId>
    <version>3.4.4</version>
    <scope>test</scope>
</dependency>

排查方向及解决方案 #

1. 验证Mock数据是否正确加载 #

先确认swaggerMock本身不为null：在创建mock前添加打印语句，检查mock.json是否被正确读取，路径是否在测试资源目录src/test/resources下。

Swagger swaggerMock = IoUtil.readFromFile("mock.json", Swagger.class);
System.out.println(swaggerMock); // 确认此处输出不为null

2. 排查参数匹配问题 #

Mockito参数匹配器需严格匹配，可能存在以下问题：

• 实际调用的字符串参数与"{ss}"存在细微差异（如空格、转义符）
• eq(Swagger.class)匹配器与实际传入的Class对象不一致

可先简化匹配规则验证Mock是否生效：

mockUtil2.when(() -> Util.parse(anyString(), any(Class.class))).thenReturn(swaggerMock);

若Mock生效，再逐步缩小匹配范围定位具体参数不匹配原因。

3. 检查Mockito版本兼容性 #

Mockito 3.4.4版本的mockito-inline可能存在静态Mock的已知bug，建议升级到3.x系列稳定版本（如3.12.4）后重新测试。

4. 确认类加载一致性 #

确保测试代码与业务代码使用同一类加载器加载Util类：若项目使用模块化或自定义类加载器，可能导致Mock的类实例与实际调用的类实例不一致，进而Mock失效。

5. 检查静态方法特性 #

如果Util.parse方法被final修饰，Mockito-inline无法对其进行Mock（静态final方法属于类固有特性，无法被动态代理修改），此时需调整代码结构，或使用PowerMock等工具。

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