kotlinx serialization反序列化JsonArray类型转换异常解决方法

这个类型转换异常是kotlinx.serialization JSON树模型的设计导致的：所有解析得到的原始类型值（字符串、数字、布尔值、null）在内存中都是JsonLiteral类的实例，属于JsonElement类型体系的一部分，不会直接存储为Java/Kotlin的原生String对象，直接做强制类型转换必然触发异常。

根据你的使用场景选对应方式即可：

• 场景1：需要直接操作解析后的JSON树，不做强类型映射
  不要直接强转元素类型，调用JsonElement提供的扩展属性拿到原始值的内容：

import kotlinx.serialization.json.*

// 解析得到根元素
val rootElement = Json.parseToJsonElement(yourJsonStr)
// 拿到对应数组
val targetArray = rootElement.jsonObject["List"]!!.jsonArray

for (item in targetArray) {
    // 确定元素是字符串时，直接通过content属性取真实字符串值
    val strValue = item.jsonPrimitive.content
    
    // 不确定元素类型时，先做类型判断再安全取值，避免运行时异常
    val safeStr = item.jsonPrimitive.takeIf { it.isString }?.content
}

注意不要直接调用JsonLiteral.toString()取值，该方法返回的是JSON规范格式的字面量，字符串值会额外包裹前后引号，不符合业务取值预期。

• 场景2：业务场景固定，推荐直接反序列化为强类型数据类，从根源避免手动类型转换
  首先定义和JSON结构匹配的可序列化数据类：

import kotlinx.serialization.Serializable

@Serializable
data class ListWrapper(
    val List: List<String>
)

直接反序列化得到强类型对象，遍历过程不需要做任何类型转换：

import kotlinx.serialization.json.Json

val result = Json.decodeFromString<ListWrapper>(yourJsonStr)
// result.List 就是标准的List<String>类型，直接遍历即可
result.List.forEach { value ->
    println(value)
}

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