HttpResponseValidator校验200响应异常：正常响应仍触发错误咨询

你遇到的核心问题是：后端返回的200状态码里包含业务层面的错误（success: false），但Ktor默认的响应校验仅依据HTTP状态码判断成功，导致序列化时因结构不匹配抛出JsonConvertException。以下是实现正确校验的方案：

1. 定义统一响应数据类 #

先和后端返回结构对齐，定义通用的响应序列化类，覆盖成功和失败两种场景：

@Serializable
data class ApiResponse<T>(
    val success: Boolean,
    val message: String,
    val data: T? = null
)

2. 自定义校验逻辑，禁用默认状态码校验 #

放弃Ktor默认的expectSuccess = true（默认开启），手动解析响应体并根据success字段判断业务状态：

// 发起请求时禁用默认的成功状态校验
val response = client.get("target-api-url") {
    expectSuccess = false
}

// 解析统一响应体
val apiResponse = response.body<ApiResponse<YourBusinessData>>()

// 根据success字段区分处理
if (apiResponse.success) {
    // 业务成功，获取数据
    val validData = apiResponse.data ?: error("成功响应无数据返回")
    // 后续业务逻辑...
} else {
    // 业务失败，抛出异常或处理错误信息
    error("请求失败: ${apiResponse.message}")
}

3. 封装扩展函数复用（可选） #

把校验逻辑封装成HttpClient的扩展函数，简化全局调用：

suspend inline fun <reified T> HttpClient.safeRequest(url: String): T {
    return get(url) {
        expectSuccess = false
    }.let { response ->
        val apiResponse = response.body<ApiResponse<T>>()
        if (apiResponse.success) {
            apiResponse.data ?: error("成功响应数据为空")
        } else {
            error(apiResponse.message)
        }
    }
}

// 调用示例
val data = client.safeRequest<YourBusinessData>("target-api-url")

为什么官方文档的配置会出问题？ #

官方文档中的2xx校验仅判断HTTP状态码是否为2xx，只要状态码符合就会尝试把响应体序列化成你指定的成功数据类，但后端返回的错误响应结构（带success、message、data.status）和成功数据类不匹配，因此触发了JsonConvertException。通过统一响应类+手动校验success字段，就能解决这个问题。

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