使用Testcontainers测试Ktor时如何覆盖指定配置属性？

针对你的需求，有两种简单可行的方案，既能保留application.conf的原有配置，又能替换Testcontainers生成的JDBC URL：

方案1：在testApplication中合并配置项 #

利用Ktor的HOCON配置合并能力，仅覆盖需要修改的属性，无需重新配置整个环境：

import com.typesafe.config.ConfigFactory
import io.ktor.server.config.HoconApplicationConfig
import io.ktor.server.testing.testApplication
import org.testcontainers.containers.PostgreSQLContainer
import kotlin.test.Test
import kotlin.test.assertEquals

@Test
fun myTest() {
    val postgresContainer = PostgreSQLContainer("postgres:15")
    postgresContainer.start()

    testApplication {
        environment {
            // 创建仅包含需要替换属性的临时配置，合并到原有配置之上
            config = HoconApplicationConfig(
                ConfigFactory.parseMap(
                    mapOf(
                        "database.jdbcUrl" to postgresContainer.jdbcUrl,
                        "database.username" to postgresContainer.username,
                        "database.password" to postgresContainer.password
                    )
                ).withFallback(applicationConfig) // 保留原有配置作为 fallback
            )
        }

        client.get("/people").apply {
            assertEquals(HttpStatusCode.OK, status)
        }
    }

    postgresContainer.stop()
}

原理说明 #

withFallback(applicationConfig) 会让新配置仅覆盖指定的键，未指定的配置项依然沿用application.conf中的内容，完美实现"只改少量属性"的需求。

方案2：通过系统属性动态注入 #

先修改application.conf，让目标配置项引用系统属性，再在测试中设置这些系统属性：

第一步：修改application.conf #

把JDBC URL等配置改为可通过系统属性覆盖的形式：

database {
    // 使用${?XXX}语法：如果存在系统属性XXX则用它，否则用原有默认值
    jdbcUrl = ${?DB_JDBC_URL}
    username = ${?DB_USERNAME}
    password = ${?DB_PASSWORD}
    // 保留其他原有配置...
}

第二步：编写测试代码 #

在Testcontainers启动后设置系统属性，测试结束后清理避免影响其他用例：

import io.ktor.server.testing.testApplication
import org.testcontainers.containers.PostgreSQLContainer
import kotlin.test.Test
import kotlin.test.assertEquals

@Test
fun myTest() {
    val postgresContainer = PostgreSQLContainer("postgres:15")
    postgresContainer.start()

    // 设置系统属性，Ktor会自动读取这些值覆盖配置
    System.setProperty("DB_JDBC_URL", postgresContainer.jdbcUrl)
    System.setProperty("DB_USERNAME", postgresContainer.username)
    System.setProperty("DB_PASSWORD", postgresContainer.password)

    testApplication {
        client.get("/people").apply {
            assertEquals(HttpStatusCode.OK, status)
        }
    }

    // 清理系统属性，防止干扰其他测试
    System.clearProperty("DB_JDBC_URL")
    System.clearProperty("DB_USERNAME")
    System.clearProperty("DB_PASSWORD")
    postgresContainer.stop()
}

注意事项 #

如果使用JUnit 5，可以把系统属性的清理逻辑放到@AfterEach方法中，避免重复代码。

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