Kotest测试Ktor应用修改环境变量报错解决方法

抛出的InaccessibleObjectException是Java 9+模块化安全限制导致的：旧版Kotest的withEnvironment方法通过反射强行修改JVM内部存储环境变量的不可修改Map私有字段，Java 16及以上版本默认禁止对java.util包下核心类的私有成员做反射访问，因此触发异常。通过添加--add-opensJVM参数绕过限制属于不稳定的hack方案，不推荐在正式测试代码中使用。
旧资料提到的重写listeners()方法添加SystemEnvironmentTestListener的写法在Kotest 5.x版本后已经废弃，有更简单稳定的替代方案。

方案1：使用Ktor测试框架原生环境变量注入（最稳定，优先选择） #

Ktor官方提供的testApplication测试块原生支持注入独立的测试环境变量，不需要依赖反射修改全局JVM环境，不会触发模块化限制，也不会污染其他测试用例的运行环境。
你只需要把原来包裹在外面的withEnvironment块删掉，直接在testApplication内部的environment配置块中设置环境变量即可，修改后的代码结构如下：

"can get list of visitors with correct query" {
    testApplication {
        // 仅对当前测试应用生效的环境变量配置
        environment {
            env = mapOf(
                "POSTGRES_URL" to "jdbc:postgresql://localhost:5432/test",
                "POSTGRES_USERNAME" to "test_user",
                "POSTGRES_PASSWORD" to "test_pass"
            )
        }

        val client = getClient(ds)
        repeat(6) {
            registerConfirmedUser(
                client, visitor.copy(
                    email = "${TestConstants.VISITOR_EMAIL}$it",
                    username = "${TestConstants.VISITOR_USERNAME}$it",
                )
            )
        }

        val accessToken = loginUser(client, loginData).run { this.body<LoginResponseDTO>().accessToken }
        client.get("/api/v1/visitors?page=1&count=5") {
            header("Authorization", "Bearer $accessToken")
        }.apply {
            val response = this.body<VisitorPaginatedResponseDTO>()
            response.data.size.shouldBe(5)
            response.totalCount.shouldBe(6)
            response.currentPage.shouldBe(1)
        }
    }
}

如果需要给所有测试用例统一配置环境变量，可以把带环境配置的testApplication封装成自定义的扩展方法，所有测试用例统一调用这个封装方法即可，避免重复写配置代码。

方案2：使用新版Kotest系统环境扩展（适合需要全局配置环境的场景） #

如果你需要在Ktor测试块之外、整个测试生命周期全局生效的环境变量，先把Kotest升级到5.5以上版本，新版的系统环境扩展已经替换了旧的反射实现，改用字节码增强方式拦截环境变量读取逻辑，不会触发JDK模块化访问异常。
不要使用已废弃的listeners()方法，通过Kotest项目级配置实现全局环境变量注入：

1. 先引入Kotest系统扩展依赖（版本和你使用的Kotest主版本保持一致）
2. 在测试源码根目录创建项目配置类，统一配置全局环境变量：

import io.kotest.core.config.AbstractProjectConfig
import io.kotest.extensions.system.SystemEnvironmentProjectLevelExtension

class ProjectConfig : AbstractProjectConfig() {
    override fun extensions() = listOf(
        SystemEnvironmentProjectLevelExtension(
            mapOf(
                "POSTGRES_URL" to "jdbc:postgresql://localhost:5432/test",
                "POSTGRES_USERNAME" to "test_user",
                "POSTGRES_PASSWORD" to "test_pass"
            )
        )
    )
}

这个配置会自动对项目下所有测试用例生效，不需要在每个测试用例中单独写withEnvironment块。如果需要给单个用例单独设置环境变量，直接使用新版提供的withEnvironment方法即可，不会再抛出反射访问异常。

注意：如果你的应用是通过Ktor的ApplicationConfig读取配置（即通过application.conf定义的配置项），而不是直接调用System.getenv()读取环境变量，可以在testApplication的environment块中用config = MapApplicationConfig(配置键值对)的方式注入配置，和env参数的用法一致。

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