Mockito单元测试被测方法与Mock函数参数不一致问题解决

你遇到的参数不匹配问题本质是原生Mockito默认不支持静态方法Mock，测试执行过程中API.get()这个静态调用没有被拦截，实际返回了null，自然和你预期的TEST_USER不匹配。直接用anyString()确实能绕过校验，但完全没校验用户参数的传递逻辑，失去了这部分测试的意义。

有两种可落地的解决方式，优先推荐第一种从代码设计层面优化的方案，长期可维护性更好。

方案1：优化依赖注入，解耦静态方法调用 #

静态方法硬编码调用会直接提升代码耦合度，降低可测试性，最优做法是把静态API的调用封装成可注入的普通组件，后续就可以用普通Mock逻辑处理。

1. 先封装静态API调用逻辑

// 专门封装用户上下文获取逻辑，隔离静态依赖
public class CurrentUserProvider {
    public String get() {
        return API.get();
    }
}

2. 调整Controller代码，通过注入方式获取组件，不再直接硬调用静态方法

public class Controller {
     private Service service;
     private CurrentUserProvider userProvider;

     // 构造函数注入，测试时可以直接传入Mock实例
     public Controller(Service service, CurrentUserProvider userProvider) {
         this.service = service;
         this.userProvider = userProvider;
     }

     public void testingFunction(String path, String name){
           String user = userProvider.get();
           this.service.putInformation(path, name, user);  
     }
}

3. 调整单测代码，直接Mock封装后的组件即可

@Mock
Service service;
@Mock
CurrentUserProvider userProvider;

private Controller controller;
private static final String TEST_USER = "userName";
private static final String PATH = "test path";
private static final String NAME = "test name";

@BeforeEach
void setUp() {
    MockitoAnnotations.openMocks(this);
    controller = new Controller(service, userProvider);
    // 打桩返回预设的测试用户
    when(userProvider.get()).thenReturn(TEST_USER);
}

@Test
public void valid_test() {
    controller.testingFunction(PATH, NAME);
    Mockito.verify(service).putInformation(eq(PATH), eq(NAME), eq(TEST_USER));
}

这种方案不需要依赖Mock框架的特殊能力，单测稳定性高，也符合依赖倒置的设计原则。

方案2：直接Mock静态方法（适合无法修改业务代码的场景） #

如果你暂时没法调整原有业务代码，可以用Mockito 3.4.0及以上版本内置的静态方法Mock能力实现，不需要引入第三方依赖。注意静态Mock要控制在最小作用域，避免干扰其他测试用例。
调整后的单测代码如下：

@Mock
Service service;

@InjectMocks
Controller controller;

private static final String TEST_USER = "userName";
private static final String PATH = "test path";
private static final String NAME = "test name";

@Test
public void valid_test() {
    // 用try-with-resources管理静态Mock生命周期，作用域结束后自动释放，不会污染其他用例
    try (MockedStatic<API> apiMock = Mockito.mockStatic(API.class)) {
        // 打桩静态方法返回预设测试用户
        apiMock.when(API::get).thenReturn(TEST_USER);
        
        controller.testingFunction(PATH, NAME);
        Mockito.verify(service).putInformation(eq(PATH), eq(NAME), eq(TEST_USER));
    }
}

注意：不要把MockedStatic实例定义为测试类的全局变量，否则多测试用例执行时会出现静态方法被意外拦截的问题，导致用例结果不稳定。

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