Ktor testApplication集成ContentNegotiation测试客户端请求失败

出现这个问题的核心原因通常是测试客户端的ContentNegotiation配置不完整，或者请求体类的Jackson序列化条件不满足，以下是具体的排查和解决步骤：

1. 确保测试客户端显式配置ContentNegotiation #

测试客户端的插件配置独立于服务端，必须在创建测试客户端时单独安装并配置ContentNegotiation，不能依赖服务端的配置。

正确的测试代码示例：

testApplication {
    // 服务端配置
    application {
        install(ContentNegotiation) {
            jackson()
        }
        routing {
            post("/api/endpoint") {
                val body = call.receive<SomeBody>()
                call.respond(HttpStatusCode.OK)
            }
        }
    }

    // 关键：测试客户端必须单独配置ContentNegotiation
    val client = createClient {
        install(ContentNegotiation) {
            jackson {
                // 可选配置：忽略未知字段、启用缩进等
                configure(DeserializationFeature.FAIL_ON_UNKNOWN_PROPERTIES, false)
                enable(SerializationFeature.INDENT_OUTPUT)
            }
        }
    }

    // 发送请求时的正确写法
    val response = client.post("/api/endpoint") {
        contentType(ContentType.Application.Json)
        setBody(SomeBody("sample content"))
    }

    // 断言响应状态
    assertEquals(HttpStatusCode.OK, response.status)
}

2. 检查请求体类的序列化兼容性 #

Jackson对序列化类有几个基础要求，确保SomeBody满足以下条件：

• 如果是普通类：必须包含无参构造函数，字段为public或提供getter方法
• 如果是data class：默认生成的getter和构造函数即可满足，但如果有非空参数，确保序列化时字段有值
• 必要时添加Jackson注解（如@JsonProperty）指定字段映射

示例兼容的SomeBody类：

// Data class（推荐，自动满足序列化要求）
data class SomeBody(val content: String)

// 普通类（需要无参构造）
class SomeBody {
    lateinit var content: String
    
    constructor() // 必须的无参构造
    constructor(content: String) {
        this.content = content
    }
}

3. 确认测试依赖完整性 #

确保你的build.gradle.kts或pom.xml中包含测试所需的Jackson序列化依赖：

// Gradle示例
testImplementation("io.ktor:ktor-client-content-negotiation:$ktorVersion")
testImplementation("io.ktor:ktor-serialization-jackson:$ktorVersion")
testImplementation("com.fasterxml.jackson.module:jackson-module-kotlin:$jacksonVersion")

4. 显式指定请求ContentType #

虽然ContentNegotiation插件会自动处理，但显式指定contentType(ContentType.Application.Json)可以避免自动推断的问题，尤其是在复杂场景下。

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