如何用JUnit5和MockK Mock Kotlin单例对象内的字段？

针对你用object定义的Sender单例，要Mock其中私有emailSender字段来测试sendMessage方法，完全可以通过MockK配合Kotlin反射实现，具体步骤和代码示例如下：

核心实现思路 #

MockK支持通过mockkObject劫持Kotlin单例，再结合Kotlin反射API修改私有成员变量，替换为Mock实例，从而实现对依赖方法的行为验证。

测试代码示例 #

import io.mockk.every
import io.mockk.mockk
import io.mockk.mockkObject
import io.mockk.unmockkObject
import io.mockk.verify
import org.junit.jupiter.api.AfterEach
import org.junit.jupiter.api.Test

class SenderTest {
    // 提前创建EmailSender的Mock实例
    private val mockEmailSender = mockk<EmailSender>(relaxed = true)

    // 测试后清理单例的Mock状态，避免影响其他测试用例
    @AfterEach
    fun cleanUp() {
        unmockkObject(Sender)
    }

    @Test
    fun `sendMessage 应调用emailSender的send方法并传入正确Message`() {
        // 1. 劫持Sender单例，使其可被MockK修改
        mockkObject(Sender)
        // 2. 通过反射修改私有字段emailSender为Mock实例
        Sender::emailSender.set(Sender, mockEmailSender)

        // 3. 执行待测试方法
        val testContent = "测试消息内容"
        Sender.sendMessage(testContent)

        // 4. 验证Mock实例的send方法是否被调用
        verify {
            mockEmailSender.send(any<Message>())
        }

        // 若需更精准验证Message参数内容，可添加断言
        verify {
            mockEmailSender.send(withArg { message ->
                assert(message.text == testContent)
            })
        }
    }
}

关键注意事项 #

• Sender::emailSender.set是Kotlin反射API，用于突破私有字段的访问限制，配合mockkObject才能顺利修改单例成员。
• 必须在@AfterEach中执行unmockkObject(Sender)，否则单例的Mock状态会残留，导致其他测试用例出现异常。
• 若EmailSender.send有返回值，可通过every { mockEmailSender.send(...) } returns ...预设返回结果。

优化建议（可选） #

如果后续需要频繁测试这类依赖，建议将Sender从object单例改为普通类，通过构造方法注入依赖：

class Sender(private val emailSender: EmailSender = EmailSender()) {
    fun sendMessage(text: String) {
        val message = Message(text)
        message.createHeader()
        emailSender.send(message)
    }
}

这样测试时直接传入Mock实例即可，无需反射，测试代码更简洁易维护。

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