Ktor处理数组空响应时遇NoTransformationFoundException的解决办法

针对你遇到的接口返回两种JSON结构、序列化失败的问题，不需要只捕获异常，可以通过定义统一密封类+自定义多态序列化器的方式，完整解析两种响应结构并保留所有数据，具体步骤如下：

1. 定义覆盖两种响应的密封类及数据结构 #

用密封类封装成功/失败两种响应类型，分别对应接口返回的JSON结构：

import kotlinx.serialization.*
import kotlinx.serialization.json.*

// 基础User数据类
@Serializable
data class User(val id: Int, val name: String)

// 统一响应密封类
sealed class BaseUserResponse {
    // 成功响应：含有效User数组
    @Serializable
    data class Success(val data: List<User>) : BaseUserResponse()

    // 失败响应：空data数组+message+default数组
    @Serializable
    data class Failure(val data: List<Nothing>, val message: String, val default: List<String>) : BaseUserResponse()
}

2. 自定义多态序列化器 #

实现JsonContentPolymorphicSerializer，根据JSON结构自动选择对应的解析器：

object BaseUserResponseSerializer : JsonContentPolymorphicSerializer<BaseUserResponse>(BaseUserResponse::class) {
    override fun selectDeserializer(element: JsonElement): DeserializationStrategy<out BaseUserResponse> {
        val jsonObject = element.jsonObject
        // 依据接口特征判断：失败响应含message且data为空数组
        return if (jsonObject.containsKey("message") && jsonObject["data"]?.jsonArray?.isEmpty() == true) {
            BaseUserResponse.Failure.serializer()
        } else {
            BaseUserResponse.Success.serializer()
        }
    }
}

3. 配置Ktor客户端的序列化器 #

在Ktor客户端的JsonFeature中配置自定义序列化器，同时开启忽略未知字段避免结构差异报错：

val client = HttpClient(OkHttp) {
    install(JsonFeature) {
        serializer = KotlinxSerializer(Json {
            ignoreUnknownKeys = true
            serializersModule = SerializersModule {
                polymorphic(BaseUserResponse::class) {
                    subclass(BaseUserResponse.Success::class)
                    subclass(BaseUserResponse.Failure::class)
                    defaultDeserializer { BaseUserResponseSerializer }
                }
            }
        })
    }
}

4. 调用接口并处理响应 #

直接接收BaseUserResponse类型，通过when分支处理成功/失败场景，完整获取所有响应数据：

val response = client.get<BaseUserResponse>("your-api-endpoint")
when (response) {
    is BaseUserResponse.Success -> {
        // 处理成功逻辑：使用response.data（有效User列表）
    }
    is BaseUserResponse.Failure -> {
        // 处理失败逻辑：使用response.message、response.default
    }
}

关键说明 #

• 密封类确保了响应类型的穷尽处理，不会遗漏情况；
• 自定义序列化器通过接口的特征字段（如message、空data数组）精准匹配解析逻辑；
• ignoreUnknownKeys = true避免因响应中存在未定义字段导致序列化失败。

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