如何在JUnit 5中Mock静态方法？附场景与依赖说明

为什么JUnit 5里Mock静态方法更麻烦？ #

JUnit 5（Jupiter）采用了全新的扩展模型，和JUnit 4的Runner机制完全不同。之前JUnit 4用的PowerMockito是靠篡改字节码+JUnit 4的Runner来实现静态方法Mock的，这套逻辑没法直接适配JUnit 5的扩展体系。另外，静态方法属于类本身而非实例，Mock它需要修改类的字节码，这种操作在JUnit 5的安全模型下需要专门的适配工具，不像Mock实例方法那么直接。

JUnit 5中Mock静态方法的两种可行方案 #

方案1：Mockito-inline（推荐，轻量无额外依赖冲突） #

Mockito从3.4版本开始支持通过mockito-inline模块实现静态方法Mock，完美兼容JUnit 5。

第一步：补充Pom依赖

在你现有JUnit 5依赖的基础上，添加Mockito相关依赖：

<!-- 原有JUnit 5依赖保留 -->
<dependency>
    <groupId>org.junit.jupiter</groupId>
    <artifactId>junit-jupiter-engine</artifactId>
    <version>5.8.2</version>
    <scope>test</scope>
</dependency>
<dependency>
    <groupId>org.junit.jupiter</groupId>
    <artifactId>junit-jupiter-api</artifactId>
    <version>5.8.2</version>
    <scope>test</scope>
</dependency>

<!-- 新增Mockito依赖 -->
<dependency>
    <groupId>org.mockito</groupId>
    <artifactId>mockito-core</artifactId>
    <version>4.11.0</version>
    <scope>test</scope>
</dependency>
<dependency>
    <groupId>org.mockito</groupId>
    <artifactId>mockito-inline</artifactId>
    <version>4.11.0</version>
    <scope>test</scope>
</dependency>
<dependency>
    <groupId>org.mockito</groupId>
    <artifactId>mockito-junit-jupiter</artifactId>
    <version>4.11.0</version>
    <scope>test</scope>
</dependency>

第二步：编写测试用例

假设你要Mock的静态类是StaticTool，它的getData()方法返回null，现在要Mock成返回"Mocked Data"：

import org.junit.jupiter.api.Test;
import org.mockito.MockedStatic;
import static org.mockito.Mockito.*;
import static org.junit.jupiter.api.Assertions.*;

public class YourServiceTest {

    @Test
    void testServiceLogic() {
        // 使用try-with-resources自动管理Mock的生命周期，避免影响其他测试
        try (MockedStatic<StaticTool> mockedStatic = mockStatic(StaticTool.class)) {
            // 设定静态方法的返回值
            mockedStatic.when(StaticTool::getData).thenReturn("Mocked Data");
            
            // 实例化你的服务类并调用目标方法
            YourService service = new YourService();
            String result = service.useStaticMethod();
            
            // 验证结果和静态方法调用次数
            assertEquals("Mocked Data", result);
            mockedStatic.verify(StaticTool::getData, times(1));
        }
    }
}

方案2：PowerMock（兼容JUnit 5，适合习惯PowerMock的场景） #

如果你之前用惯了PowerMock，也可以用它的JUnit 5扩展版本实现静态方法Mock，但注意它的字节码篡改可能和部分工具冲突。

第一步：补充Pom依赖

<!-- 原有JUnit 5依赖保留 -->
<dependency>
    <groupId>org.junit.jupiter</groupId>
    <artifactId>junit-jupiter-engine</artifactId>
    <version>5.8.2</version>
    <scope>test</scope>
</dependency>
<dependency>
    <groupId>org.junit.jupiter</groupId>
    <artifactId>junit-jupiter-api</artifactId>
    <version>5.8.2</version>
    <scope>test</scope>
</dependency>

<!-- 新增PowerMock依赖 -->
<dependency>
    <groupId>org.powermock</groupId>
    <artifactId>powermock-module-junit5</artifactId>
    <version>2.0.9</version>
    <scope>test</scope>
</dependency>
<dependency>
    <groupId>org.powermock</groupId>
    <artifactId>powermock-api-mockito2</artifactId>
    <version>2.0.9</version>
    <scope>test</scope>
</dependency>

第二步：编写测试用例

import org.junit.jupiter.api.Test;
import org.junit.jupiter.api.extension.ExtendWith;
import org.powermock.core.classloader.annotations.PrepareForTest;
import org.powermock.modules.junit5.PowerMockExtension;
import static org.powermock.api.mockito.PowerMockito.*;
import static org.junit.jupiter.api.Assertions.*;

@ExtendWith(PowerMockExtension.class)
@PrepareForTest(StaticTool.class) // 声明要Mock的静态类
public class YourServiceTest {

    @Test
    void testServiceLogic() {
        // Mock静态方法的返回值
        when(StaticTool.getData()).thenReturn("Mocked Data");
        
        YourService service = new YourService();
        String result = service.useStaticMethod();
        
        assertEquals("Mocked Data", result);
        // 验证静态方法被调用
        verifyStatic(StaticTool.class);
        StaticTool.getData();
    }
}

额外提醒 #

虽然能Mock静态方法，但还是建议尽量减少静态方法的滥用——静态方法会让代码耦合度变高，不仅测试麻烦，后续扩展和维护也会更费劲。如果可以的话，考虑把静态方法重构为实例方法，或者通过依赖注入的方式解耦。

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