如何基于全新配置实现Ktor服务的独立测试？

你的核心问题出在全局静态数据源上——静态变量的生命周期是JVM进程级别的，哪怕重启TestApplicationEngine，静态列表的数据也不会被重置。要实现测试用例完全独立，关键是消除全局状态，让每个测试都拥有全新的数据源实例。

下面是具体的实现方案：

1. 替换全局静态数据源为模块局部状态 #

把原来的全局静态列表，改成在Ktor模块内部初始化的局部变量，这样每次启动Application都会创建一个全新的空列表：

修改前（有问题的写法） #

// 全局静态类，导致测试数据残留
object UserRepository {
    val users = mutableListOf<User>()
}

fun Application.module() {
    routing {
        post("/users") {
            val user = call.receive<User>()
            UserRepository.users.add(user)
            call.respond(HttpStatusCode.Created)
        }
    }
}

修改后（隔离状态） #

fun Application.module() {
    // 每次启动Application都新建一个空列表，属于当前Application实例私有
    val users = mutableListOf<User>()

    routing {
        post("/users") {
            val user = call.receive<User>()
            users.add(user)
            call.respond(HttpStatusCode.Created)
        }
        get("/users") {
            call.respond(users)
        }
    }
}

2. 用依赖注入管理数据源（更灵活的方案） #

如果你的项目需要更复杂的依赖管理，推荐用Ktor原生DI或第三方DI框架（如Koin），确保每次测试都注入全新的数据源实例：

步骤1：定义数据源接口与实现 #

interface UserRepository {
    fun addUser(user: User)
    fun getUsers(): List<User>
}

// 每个实例持有独立的用户列表
class InMemoryUserRepository : UserRepository {
    private val users = mutableListOf<User>()

    override fun addUser(user: User) {
        users.add(user)
    }

    override fun getUsers(): List<User> = users.toList()
}

步骤2：在Ktor模块中配置DI #

fun Application.module() {
    install(DependencyInjection) {
        // 每次请求Application时，创建新的InMemoryUserRepository实例
        bind<UserRepository>() with factory { InMemoryUserRepository() }
    }

    routing {
        val repo = application.locator<UserRepository>()
        post("/users") {
            val user = call.receive<User>()
            repo.addUser(user)
            call.respond(HttpStatusCode.Created)
        }
        get("/users") {
            call.respond(repo.getUsers())
        }
    }
}

步骤3：测试类保持原有启停逻辑 #

class ApiTest {
    private lateinit var engine: TestApplicationEngine
    private lateinit var client: HttpClient

    @BeforeTest
    fun setup() {
        engine = TestApplicationEngine.create {
            module()
        }
        engine.start()
        client = HttpClient(engine)
    }

    @AfterTest
    fun teardown() {
        client.close()
        engine.stop()
    }

    @Test
    fun testAddUser() {
        // 测试逻辑...
    }

    @Test
    fun testEmptyUserList() {
        // 测试逻辑...
    }
}

关键注意点 #

• 不要依赖JVM全局静态变量存储测试数据，所有状态都要绑定到Application实例或通过DI注入的实例中。
• 确保每个测试启动的是全新的TestApplicationEngine，不要复用全局引擎实例。
• 如果使用第三方DI框架（如Koin），需要在@BeforeTest中重新初始化DI上下文，@AfterTest中销毁上下文，避免跨测试的依赖残留。

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