MockK模拟原始类型Value Class时的断言失败与类型转换异常问题

问题场景 #

在Kotlin 1.9.23 + MockK 1.3.10环境下，模拟函数返回基于Long/Int等原始类型的Value Class时，会出现两类异常：

• 断言失败：实际返回的是原始类型值（比如Long），而非预期的Value Class实例
• ClassCastException：运行时抛出无法将原始类型转换为对应Value Class的异常

但基于String这类引用类型的Value Class，模拟返回完全正常。

原因分析 #

核心问题出在Kotlin Value Class的编译优化机制：

• 原始类型的Value Class会被编译器内联处理，运行时多数场景下直接以原始值形式存在，不会保留Value Class的实例结构
• String作为引用类型，其Value Class不会被完全内联，MockK能正确识别并生成对应的实例
• MockK 1.3.10版本对原始类型内联的Value Class支持不完善，无法自动完成从原始值到Value Class实例的转换

可行解决办法 #

1. 优先升级MockK版本 #

MockK后续稳定版本（如1.13.8及以上）已经修复了该兼容性问题，升级后无需额外修改代码即可正常模拟。更新依赖示例：

// Gradle Kotlin DSL
testImplementation("io.mockk:mockk:1.13.8")

2. 手动包装原始值为Value Class实例 #

如果暂时无法升级依赖，在mock时手动创建Value Class实例返回，绕过MockK的自动转换逻辑：

// 示例Value Class定义
@JvmInline value class UserId(val value: Long)

// Mock代码
val mockService = mockk<UserService>()
every { mockService.getUserId() } returns UserId(123L)

批量返回时同样需要逐个包装：

every { mockService.getUserId() } returnsMany listOf(UserId(123L), UserId(456L))

3. 给Value Class添加静态创建方法（可选） #

为了提升mock代码的可读性，可以在Value Class中添加静态创建方法：

@JvmInline
value class UserId(val value: Long) {
    companion object {
        @JvmStatic
        fun of(value: Long): UserId = UserId(value)
    }
}

// Mock时调用静态方法
every { mockService.getUserId() } returns UserId.of(123L)

4. 使用answer自定义返回逻辑 #

针对动态生成返回值的复杂场景，用answer手动返回实例：

every { mockService.getUserId() } answers { 
    // 这里可以添加动态逻辑，比如根据参数生成值
    UserId(System.currentTimeMillis())
}

内容的提问来源于stack exchange，提问作者Ken'ichi Ogawa