如何在Ktor中测试Basic Authentication？测试请求返回未授权

问题描述 #

• 路由与安全配置在运行中的应用可正常工作，未认证路由的测试用例能够正常访问，但以下认证测试用例执行失败：

@Test
fun passesAuth() {
    withTestApp { app ->
        app.startApplication()
        runBlocking {
            val response = app.client.get("/bot") {
                val authString = getAuthString()
                header(HttpHeaders.Authorization, authString)
            }
            assertEquals(HttpStatusCode.OK, response.status)
            assertEquals("Hello Bot!", response.bodyAsText())
        }
    }
}

• 请求头格式符合预期，且在Postman中调用常规应用时可正常通过认证，但测试用例始终返回Unauthorized响应。

相关应用配置代码 #

fun withTestApp(test: (ApplicationTestBuilder) -> Unit) {
    val testConfig = ApplicationConfig("unit-testing.conf")
    testApplication {
        environment {
            config = testConfig
        }
        application{
            this.module(dependencies = testModule, config = testConfig)
        }
        test(this)
    }
}

fun Application.module(dependencies: Module = koinModule, config: ApplicationConfig = this.environment.config) {
    ConfigAccessor.config = config
    configureSerialization()
    configureHTTP()
    configureSecurity()
    configureRouting()
    install(Koin) {
        slf4jLogger(org.koin.core.logger.Level.ERROR)
        modules(dependencies)
    }
}

排查与解决方案 #

1. 核对测试环境配置
   确认unit-testing.conf中的安全相关配置（如认证密钥、权限规则）和生产环境完全一致，测试环境常因配置遗漏或错误导致认证逻辑不匹配。
2. 验证认证字符串生成逻辑
   在测试用例中打印getAuthString()返回的具体内容，和Postman中使用的有效值对比，确认测试环境生成的认证串是否正确（比如是否用了测试环境的密钥签名）。
3. 检查Koin测试依赖替换
   确认testModule是否正确替换了认证相关服务，避免因误用模拟实现导致验证逻辑失效。
4. 排查安全中间件初始化
   在configureSecurity()函数中添加日志输出，确认测试环境下安全中间件是否正确加载配置、启用了预期的认证策略。
5. 修正测试用例的应用启动方式
   testApplication会自动管理应用的启动和生命周期，手动调用app.startApplication()可能导致中间件初始化异常，移除该行代码后重试：

   @Test
   fun passesAuth() {
       withTestApp { app ->
           runBlocking {
               val response = app.client.get("/bot") {
                   val authString = getAuthString()
                   header(HttpHeaders.Authorization, authString)
               }
               assertEquals(HttpStatusCode.OK, response.status)
               assertEquals("Hello Bot!", response.bodyAsText())
           }
       }
   }
   

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