Kotlin Multiplatform项目引入mockk-common后使用时报未解析引用问题

报错核心原因 #

• 项目使用的MockK版本1.10.4发布时，MockK还未完成正式的Kotlin Multiplatform适配，对应发布的mockk-common构件只是空的占位包，不包含任何可被编译器识别的真实类定义。即便Gradle能正常拉取构件、完成项目构建流程，编译测试代码时也找不到io.mockk包下的任何类，最终抛出未解析引用错误。
• 依赖配置不符合KMP的源码映射规则：MockK的KMP适配采用expect/actual双端声明机制，仅在common测试源集添加单独的mockk-common依赖，无法匹配各平台对应的实际实现类，会进一步导致引用识别失败。
• 早年MockK实验性适配KMP阶段的公开接入说明没有及时更新，文档中仅要求添加testImplementation "io.mockk:mockk-common:{version}"的操作方法，和当前正式发布的构件结构不匹配，按旧指引操作很容易出现构建正常但编译测试代码失败的问题。

正确配置流程 #

1. 将MockK版本升级到1.12.0及以上的稳定正式版，替换掉1.10.4的过时版本。
2. 调整Gradle源码集依赖配置，替换原有的空占位依赖写法，参考如下可正常运行的配置：

kotlin {
    val hostOs = System.getProperty("os.name")
    val isMingwX64 = hostOs.startsWith("Windows")
    val nativeTarget = when {
        hostOs == "Mac OS X" -> macosX64("native")
        hostOs == "Linux" -> linuxX64("native")
        isMingwX64 -> mingwX64("native")
        else -> throw GradleException("Host OS is not supported in Kotlin/Native.")
    }

    nativeTarget.apply {
        binaries {
            executable {
                entryPoint = "main"
            }
        }
    }
    sourceSets {
        val nativeMain by getting
        val nativeTest by getting {
            // 为Native测试源集添加专属的MockK原生适配实现
            dependencies {
                implementation("io.mockk:mockk-native:1.13.8")
            }
        }
        val commonTest by getting {
            dependencies {
                implementation(kotlin("test-common"))
                implementation(kotlin("test-annotations-common"))
                // 替换原有低版本空占位包，使用带完整KMP元数据的统一依赖入口
                implementation("io.mockk:mockk:1.13.8")
            }
        }
    }
}

3. 配置修改完成后，执行Gradle同步并清理项目旧构建缓存，避免之前拉取的空占位构件残留导致识别异常。

配置注意事项 #

• 不要继续使用单独指向mockk-common的依赖坐标作为KMP项目的引入入口，当前正式版MockK已经把KMP适配的公共元数据整合到统一的io.mockk:mockk:{version}构件中，Gradle会自动完成各平台的依赖匹配。
• Kotlin/Native平台没有JVM端的反射能力，无法复用JVM版本的MockK实现，必须在对应平台的test源集单独引入mockk-native构件，才能正常运行MockK的测试逻辑。

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