Kotlin中Mockito用ArgumentMatchers存根Mock时参数为null问题求助

一、参数提示为null的原因 #

这个错误的核心是存根的参数/匹配器与实际调用不匹配，触发了Mockito严格存根模式的校验：

1. 匹配器使用错误：如果存根时误将参数设为null，或者匹配器顺序、类型写错（比如把模板路径和Context参数搞反），严格存根会认为存根的参数是null，和实际传入的具体值不匹配。
2. Kotlin空安全冲突：Kotlin的非空类型约束如果和Mockito匹配器结合不当，可能导致匹配器被解析为null，比如在非空参数位置错误使用未正确处理的匹配器。
3. refEq匹配失败：refEq需要对象字段完全相等才能匹配，而控制器内创建的Context和测试中实例化的不是同一个对象，字段哪怕有细微差异（比如默认属性）都会导致匹配失败，Mockito会判定存根参数不匹配，进而提示存根的是null。

二、解决方法与Mocking最佳实践 #

1. 正确使用参数匹配器 #

针对ITemplateEngine.process(String, Context)方法，用匹配器规避实例相等的问题：

import org.mockito.Mockito.`when`
import org.mockito.ArgumentMatchers.*

// 存根时指定模板路径，匹配任意Context实例
`when`(templateEngine.process(eq("templates/email.html"), any(Context::class.java)))
    .thenReturn("Mocked email content")

• eq("xxx")：精确匹配模板路径字符串，确保和控制器调用的路径一致。
• any(Context::class.java)：匹配任意Context实例，避免因实例不同导致mock不生效。

2. 按需校验Context内的参数 #

如果需要验证Context中的模板变量是否正确，用argThat()自定义匹配器：

`when`(templateEngine.process(eq("templates/email.html"), argThat { context ->
    context.variables["username"] == "testUser" && context.variables["orderId"] == 123
})).thenReturn("Mocked content")

这种方式既不用依赖实例相等，又能精准校验模板参数。

3. 坚持面向接口Mock #

你目前注入ITemplateEngine接口而非具体TemplateEngine类的做法是正确的，接口方法非final，完全适配Mockito的mock逻辑，避免了final方法无法mock的问题。

4. 保证测试隔离 #

用Mockito注解自动管理mock实例，避免测试间状态污染：

@ExtendWith(MockitoExtension::class)
class EmailControllerTest {
    @Mock
    private lateinit var templateEngine: ITemplateEngine

    @InjectMocks
    private lateinit var emailController: EmailController

    @Test
    fun testSendEmail() {
        // 存根逻辑
        `when`(templateEngine.process(eq("templates/email.html"), any(Context::class.java)))
            .thenReturn("Mocked email content")
        
        // 调用控制器方法
        val response = emailController.sendTestEmail()
        
        // 验证结果与mock调用
        assertEquals("Mocked email content", response)
        verify(templateEngine).process(eq("templates/email.html"), any(Context::class.java))
    }
}

5. 谨慎关闭严格存根（临时排查用） #

如果只是临时排查问题，可以关闭严格存根，但不推荐长期使用——严格存根能帮你发现测试中的潜在逻辑问题：

@ExtendWith(MockitoExtension::class)
@MockitoSettings(strictness = Strictness.LENIENT)
class EmailControllerTest {
    // 测试代码
}

三、总结 #

• 参数提示null本质是存根与实际调用的参数不匹配，严格存根模式触发了错误提示。
• 核心最佳实践：
  • 始终面向接口mock，避免mock final类/方法。
  • 用合适的匹配器（eq/any/argThat）替代实例相等校验。
  • 利用Mockito注解保证测试隔离，减少重复代码。
  • 尽量保留严格存根模式，提前发现测试逻辑漏洞。

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