Ktor/Kotest/Koin/Mockk端点测试中模拟用例未按预期工作

核心问题定位 #

你遇到的本质问题是路由函数userRoutes没有从测试环境的Koin容器中获取Mock实例，而是直接创建了真实用例或从另一个Koin容器获取实例，导致测试与路由的用例引用完全不一致。

分步解决方法 #

1. 修正路由的依赖获取方式 #

确保userRoutes里的用例通过Koin注入，而非硬编码实例：

• 错误写法（直接创建实例，跳过Koin）：

fun Route.userRoutes() {
    val getUserInfoUseCase = GetUserInfoUseCase() // 完全脱离Koin容器
    get("/user/{id}") {
        val user = getUserInfoUseCase.call(call.parameters["id"])
        call.respond(user)
    }
}

• 正确写法1（通过Koin委托注入）：

fun Route.userRoutes() {
    val getUserInfoUseCase: GetUserInfoUseCase by inject() // 从当前Koin容器获取
    get("/user/{id}") {
        val user = getUserInfoUseCase.invoke(call.parameters["id"].orEmpty())
        call.respond(user)
    }
}

• 正确写法2（函数参数默认从Koin获取，支持测试手动传参）：

fun Route.userRoutes(
    getUserInfoUseCase: GetUserInfoUseCase = get() // 默认走Koin，测试可直接传Mock
) {
    get("/user/{id}") {
        val user = getUserInfoUseCase.invoke(call.parameters["id"].orEmpty())
        call.respond(user)
    }
}

2. 确保测试环境覆盖Koin模块 #

测试中必须替换生产模块的真实用例为Mock，且要开启覆盖模式：

// 定义测试专用Koin模块
val testAppModule = module {
    // 用override=true强制覆盖生产模块的同名实例
    single<GetUserInfoUseCase>(override = true) { mockk<GetUserInfoUseCase>() }
}

class UserRouteTests : FunSpec({
    // 加载Koin测试扩展，替换生产模块
    extension(KoinExtension(testAppModule))

    val getUserInfoUseCase: GetUserInfoUseCase by inject()

    beforeTest {
        // 提前设置Mock的返回逻辑，必须在服务器启动前完成
        coEvery { getUserInfoUseCase.invoke(any()) } returns UserInfo("test-id", "test-name")
    }

    test("GET /user/{id} 返回模拟用户数据") {
        withTestApplication({ module(testing = true) }) {
            handleRequest(HttpMethod.Get, "/user/123").apply {
                assertEquals(HttpStatusCode.OK, response.status())
                assertEquals(UserInfo("test-id", "test-name"), response.content?.parseJson())
            }
        }
    }
})

3. 验证Koin容器一致性 #

如果问题依旧，在测试和路由中分别打印实例的hashCode，确认是否来自同一个容器：

• 测试中打印：println("测试用例hash: ${getUserInfoUseCase.hashCode()}")
• 路由中打印：println("路由用例hash: ${getUserInfoUseCase.hashCode()}")
  若两个hash值不同，说明：
• 测试模块未成功加载或未覆盖生产模块
• 应用启动时单独加载了生产模块，未合并测试模块

4. 避免服务器启动在Mock设置之前 #

必须先完成Mock的coEvery配置，再启动Ktor测试服务器，绝对不能在withTestApplication内部才设置Mock。

常见坑点 #

• 路由里硬编码创建用例，完全绕过Koin注入逻辑
• 测试模块未添加override=true，导致生产实例未被替换
• 测试用的Koin容器与应用启动的容器不是同一个（比如应用单独加载生产模块，未合并测试模块）

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