kotlinx serialization实现多态子类反序列化的最优方案是什么

针对你描述的type字段控制data字段结构的JSON场景，不需要完全自定义KSerializer，直接使用kotlinx.serialization官方提供的能力即可实现，根据你的场景复杂度可以选择以下两种方案：

方案1：官方多态序列化配置（适合多类型、易迭代场景） #

该方案利用kotlinx.serialization内置的多态支持，后续新增类型只需要新增绑定即可，无需修改反序列化主逻辑。

步骤1：定义基础数据结构 #

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

// 所有data类型的公共父接口/密封类
@Serializable
sealed interface BaseData

// type=type_1对应的data结构
@Serializable
data class Type1(val field1: String, val field2: Int) : BaseData

// type=type_2对应的data结构
@Serializable
data class Type2(val fieldA: Boolean, val fieldB: List<String>) : BaseData

// 外层JSON结构定义
@Serializable
data class Wrapper(
    val type: String,
    val data: BaseData
)

步骤2：配置Json实例的多态规则 #

val json = Json {
    serializersModule = SerializersModule {
        polymorphic(BaseData::class) {
            // 绑定type值和对应的data类
            subclass(Type1::class, "type_1")
            subclass(Type2::class, "type_2")
        }
    }
    // 配置多态鉴别器从外层type字段取值，而非data内部字段
    polymorphicDiscriminator = { descriptor ->
        if (descriptor.serialName == BaseData::class.qualifiedName) JsonPrimitive("type")
        else null
    }
    ignoreUnknownKeys = true // 可选，按需开启
}

使用方式 #

val result = json.decodeFromString<Wrapper>(jsonStr)
// 后续可以直接用when判断result.data的类型做对应处理

方案2：轻量手动映射（适合类型少、迭代频率低的场景） #

如果你的场景类型数量非常少，也可以用更直观的两步反序列化方案，不需要额外配置多态模块：

// 第一步：先反序列化为中间结构，data保留原始JsonElement
@Serializable
data class RawWrapper(
    val type: String,
    val data: JsonElement
)

// 反序列化逻辑
fun parseJson(jsonStr: String): Any {
    val rawWrapper = Json.decodeFromString<RawWrapper>(jsonStr)
    return when(rawWrapper.type) {
        "type_1" -> Json.decodeFromJsonElement<Type1>(rawWrapper.data)
        "type_2" -> Json.decodeFromJsonElement<Type2>(rawWrapper.data)
        else -> throw IllegalArgumentException("不支持的type值: ${rawWrapper.type}")
    }
}

两种方案都避免了完全自定义KSerializer需要手动处理字段解析、边界异常的繁琐操作，全部基于官方内置能力实现，性能和稳定性都有保障。

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