Ktor如何处理HTTP 204空响应 使client.get()返回null而非抛异常

Ktor客户端默认的反序列化流程在遇到HTTP 204 No Content响应时，响应体长度为0，找不到匹配目标实体类型的反序列化转换器，因此抛出io.ktor.client.call.NoTransformationFoundException。你提到的HttpResponseValidator仅用于校验响应合法性、抛出自定义异常，不支持修改接口返回值，无法直接通过它实现需求，可通过以下几种方案实现空响应返回null的效果：

方案1：单次调用手动判断（最稳妥无侵入） #

不直接指定反序列化的实体泛型，先接收HttpResponse对象，手动判断状态码后再处理反序列化：

// 先拿到原始响应
val response: HttpResponse = client.get(url)
// 204场景直接赋值null，其余场景正常反序列化
val myEntity: MyEntity? = when (response.status) {
    HttpStatusCode.NoContent -> null
    else -> response.body()
}

该方案不需要修改全局HttpClient配置，适合仅少量接口需要处理204场景的情况。

方案2：全局配置空体转换器（统一处理） #

如果项目中大量接口存在204返回空的场景，可以在初始化Json序列化插件时自定义接收逻辑，全局适配空响应：

val client = HttpClient(CIO) { // 替换为你实际使用的客户端引擎，如OkHttp、Java等
    install(JsonFeature) {
        serializer = KotlinxSerializer(Json {
            // 保留你原有的Json配置，比如忽略未知键、宽松解析等
            ignoreUnknownKeys = true
            isLenient = true
        })

        // 自定义空响应接收逻辑
        receive<Any?> { type, response ->
            val contentLength = response.contentLength()
            // 204状态码 或 响应体长度为0时，若目标类型是可空类型直接返回null
            if (response.status == HttpStatusCode.NoContent || (contentLength != null && contentLength == 0L)) {
                if (type.isMarkedNullable) {
                    null
                } else {
                    // 目标类型非空时维持原有异常逻辑
                    throw NoTransformationFoundException(type, response)
                }
            } else {
                // 正常响应走原有反序列化逻辑
                super.receive(type, response)
            }
        }
    }
}

配置完成后，只要将接收变量声明为可空类型，遇到204空响应就会自动返回null，不需要每个接口单独写判断：

// 声明为MyEntity?可空类型即可自动适配
val myEntity: MyEntity? = client.get(url)

方案3：全局响应拦截提前返回null #

通过拦截客户端发送管道的响应后置节点，在反序列化逻辑执行前就对204响应做处理，直接返回null：

val client = HttpClient {
    // 保留原有配置
    sendPipeline.intercept(HttpSendPipeline.After) { response ->
        if (response.status == HttpStatusCode.NoContent) {
            // 拦截后直接返回null，跳过后续反序列化流程
            proceedWith(null)
        }
    }
}

注意事项 #

• 所有返回null的场景，对应的接收变量必须声明为可空类型（类型后缀带?），否则会触发Kotlin空安全异常。
• 不建议通过强行捕获NoTransformationFoundException返回null的方式处理，会误伤其他真正的反序列化失败场景，不利于问题排查。

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