Kotlinx.serialization处理异构JSON数组的最佳实践

在实际开发中，我们经常会遇到需要处理包含多种类型元素的JSON数组的情况。本文将以Kotlinx.serialization库为例，深入探讨如何优雅地处理这类异构数据结构。

问题场景分析

假设我们需要处理如下JSON数据：

[
  {"key": "mac", "value": "3C:D1:6E:38:A2:43"},
  {"key": "status", "value": 0},
  {"key": "value", "value": 0.5},
  {"key": "json", "value": "{\"name\":\"sky\",\"age\":20,\"sex\":1}"}
]

这个数组中的每个元素都有相同的结构（包含key和value字段），但value字段的类型却各不相同（字符串、整数、浮点数、嵌套JSON等）。这种数据结构在配置信息、设备状态上报等场景中十分常见。

解决方案一：使用JsonElement

Kotlinx.serialization提供了JsonElement类型，可以动态处理各种JSON值：

@Serializable
data class KVValue(val key: String, val value: JsonElement)

// 使用时
val list = Json.decodeFromString<List<KVValue>>(jsonStr)
list.forEach { item ->
    when (item.value) {
        is JsonPrimitive -> println("Primitive: ${item.value.content}")
        is JsonObject -> println("Object: ${item.value}")
        // 其他类型处理...
    }
}

这种方法灵活性强，但需要在业务代码中做大量类型判断和转换，不够类型安全。

解决方案二：使用密封类实现类型安全

更优雅的方式是使用Kotlin的密封类特性：

@Serializable
@JsonClassDiscriminator("key")
sealed class KVValue {
    abstract val value: Any
    
    @Serializable
    @SerialName("mac")
    data class Mac(override val value: String) : KVValue()
    
    @Serializable
    @SerialName("status")
    data class Status(override val value: Int) : KVValue()
    
    @Serializable
    @SerialName("value")
    data class FloatValue(override val value: Float) : KVValue()
    
    @Serializable
    @SerialName("json")
    data class JsonValue(override val value: Person) : KVValue()
}

// 需要配置序列化模块
val module = SerializersModule {
    polymorphic(KVValue::class) {
        subclass(KVValue.Mac::class)
        subclass(KVValue.Status::class)
        subclass(KVValue.FloatValue::class)
        subclass(KVValue.JsonValue::class)
    }
}

val json = Json { serializersModule = module }

注意点：

1. 需要将JSON中的"key"字段改为"type"（库的默认要求）
2. 嵌套JSON需要是标准对象格式，不能是字符串形式
3. 需要显式配置多态序列化模块

实际应用建议

1. 数据结构设计：如果可能，建议后端返回统一格式的数据，避免异构数组
2. 类型安全优先：在业务逻辑复杂的场景，推荐使用密封类方案
3. 灵活处理：对临时性数据或不确定结构的数据，JsonElement更合适
4. 性能考量：密封类方案在编译时生成代码，运行时效率更高

扩展思考

对于更复杂的场景，可以考虑：

• 自定义序列化器处理特殊格式
• 使用JsonTransient注解过滤不需要的字段
• 结合Kotlin的反射机制实现动态处理

通过合理运用Kotlinx.serialization提供的各种特性，我们可以优雅地处理各种复杂的JSON数据结构，在灵活性和类型安全之间取得平衡。