Kotlin中Mock静态类报错：参数匹配器误用问题排查

问题场景 #

在Java环境下使用Mockito可以正常Mock静态类，但将测试代码转为Kotlin后，抛出如下错误：

Misplaced or misused argument matcher detected here: -> at TestTest.testWrapperStatic$lambda$0(TestTest.kt:19)

待Mock的静态类（Kotlin单例） #

object TextUtilsWrapper {
    @JvmStatic
    fun createFromParcel(p: Parcel): CharSequence {
        return TextUtils.CHAR_SEQUENCE_CREATOR.createFromParcel(p)
    }
}

通过的Java测试用例 #

public class TestTest extends BaseMockingUnitTest {

    @Test
    public void testWrapperStatic() {
        Parcel parcel = Mockito.mock(Parcel.class);

        final MockedStatic<TextUtilsWrapper> textUtilsWrapperMockedStatic = mockStatic(
                TextUtilsWrapper.class);
        textUtilsWrapperMockedStatic.when(
                () -> TextUtilsWrapper.createFromParcel(any())).thenReturn("hello");

        assertThat(TextUtilsWrapper.createFromParcel(parcel), is("hello"));
    }
}

失败的Kotlin测试用例 #

class TestTest : BaseMockingUnitTest() {
    @Test
    fun testWrapperStatic() {
        val parcel = Mockito.mock(Parcel::class.java)
        val textUtilsWrapperMockedStatic = Mockito.mockStatic(
            TextUtilsWrapper::class.java
        )
        textUtilsWrapperMockedStatic.`when`<Any> { createFromParcel(ArgumentMatchers.any()) }
            .thenReturn("hello")
        MatcherAssert.assertThat(createFromParcel(parcel), Matchers.`is`("hello"))
    }
}

核心差异与修复方案 #

Kotlin与Java的Mock逻辑差异 #

Java中，mockStatic的when方法接收的lambda明确指向目标静态类的方法调用，编译器能清晰识别Mock的目标；但Kotlin中如果省略类名直接写createFromParcel(any())，编译器会优先解析为当前类的方法（或因作用域问题无法关联到目标静态类），导致Mockito无法识别这是要Mock的方法，进而触发参数匹配器的误用错误。

另外，Kotlin的类型推断机制和Java不同，未指定类型的any()匹配器可能出现类型不匹配的问题。

修复后的Kotlin测试代码 #

class TestTest : BaseMockingUnitTest() {
    @Test
    fun testWrapperStatic() {
        val parcel = Mockito.mock(Parcel::class.java)
        // 使用use块自动管理MockedStatic资源，避免污染其他测试
        Mockito.mockStatic(TextUtilsWrapper::class.java).use { mockedStatic ->
            // 明确指定目标静态类的方法，避免作用域混淆
            mockedStatic.`when` { 
                TextUtilsWrapper.createFromParcel(Mockito.any(Parcel::class.java)) 
            }.thenReturn("hello")
            
            // 调用被Mock的静态方法
            val result = TextUtilsWrapper.createFromParcel(parcel)
            MatcherAssert.assertThat(result, Matchers.`is`("hello"))
        }
    }
}

关键修复点 #

• 明确指定静态方法调用者：在when的lambda中必须写TextUtilsWrapper.createFromParcel(...)，不能省略类名，确保Mockito能识别到要Mock的目标方法。
• 用use块管理资源：Kotlin的use函数会自动关闭MockedStatic，避免静态Mock残留影响其他测试用例。
• 指定匹配器的具体类型：使用Mockito.any(Parcel::class.java)替代无类型的any()，确保匹配器与方法参数类型一致，解决类型推断问题。

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