Ktor API测试：配置ContentNegotiation仍无法序列化类到HTTP请求体

核心问题：导入错误的ContentNegotiation插件 #

你当前代码中导入的是服务器端的ContentNegotiation类（io.ktor.server.plugins.contentnegotiation.ContentNegotiation），但测试客户端需要使用客户端版本的插件类，这是导致你最初安装插件报错、后续序列化失败的根本原因。

修复步骤 #

1. 替换客户端插件的导入包 #

将客户端配置中的ContentNegotiation导入替换为客户端版本：

// 替换前（服务器端插件）
import io.ktor.server.plugins.contentnegotiation.ContentNegotiation

// 替换后（客户端插件）
import io.ktor.client.plugins.contentnegotiation.ContentNegotiation

2. 确保客户端与服务器端序列化配置一致 #

如果你的configureSerialization()方法中使用了自定义的Kotlinx Json实例（比如配置忽略未知键、宽松解析等），客户端需要同步使用相同的配置，避免序列化/反序列化不兼容：

// 假设服务器端configureSerialization是这样的
fun Application.configureSerialization() {
    val json = Json {
        ignoreUnknownKeys = true
        prettyPrint = true
        isLenient = true
    }
    install(ContentNegotiation) {
        json(json)
    }
}

// 测试客户端同步使用相同的Json配置
val client = createClient {
    install(ContentNegotiation) {
        json(Json {
            ignoreUnknownKeys = true
            prettyPrint = true
            isLenient = true
        })
    }
}

3. 修正后的完整测试代码 #

package com.example

import com.example.plugins.configureRouting
import com.example.plugins.configureSerialization
import io.ktor.client.request.post
import io.ktor.client.request.setBody
import io.ktor.client.plugins.contentnegotiation.ContentNegotiation // 修正后的客户端插件导入
import io.ktor.http.ContentType
import io.ktor.http.contentType
import io.ktor.serialization.kotlinx.json.json
import io.ktor.server.testing.*
import kotlin.test.*
import kotlinx.serialization.json.Json // 自定义配置时需要导入

data class User(val email: String, val password: String)

class ApplicationTest {
    fun ApplicationTestBuilder.createEnvironment() {
        application {
            configureRouting()
            configureSerialization()
        }
    }

    @Test
    fun testRegister() = testApplication {
        createEnvironment()

        val client = createClient {
            install(ContentNegotiation) {
                // 若服务器使用默认配置，直接调用json()即可；否则同步自定义配置
                json(Json {
                    ignoreUnknownKeys = true // 示例配置，根据服务器实际情况调整
                })
            }
        }

        val validUser = User(
            "simone@gmail.com",
            "Simone_2006",
        )

        val response = client.post("/users/register") {
            contentType(ContentType.Application.Json)
            setBody(validUser)
        }

        // 可添加断言验证响应状态
        assertEquals(201, response.status.value)
    }
}

4. 检查测试依赖完整性 #

确保build.gradle.kts（或build.gradle）中包含测试所需的序列化依赖：

testImplementation("io.ktor:ktor-client-content-negotiation:$ktor_version")
testImplementation("io.ktor:ktor-serialization-kotlinx-json:$ktor_version")

验证结果 #

完成上述修改后，测试客户端即可正确将User对象序列化为JSON请求体发送给服务器，不会再出现序列化失败的错误。

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