Kotlin泛型值对象GSON序列化丢失字段问题求助

你遇到的这个问题是Gson序列化的典型多态类型处理限制：Gson默认是根据变量的静态声明类型（这里是X<String>）来扫描并序列化字段的，而不是对象的实际运行时类型Y。所以它只会序列化父类X中定义的x字段，完全忽略子类Y独有的y字段。

下面提供两种可行的解决思路，你可以根据需求选择：

方案1：使用RuntimeTypeAdapterFactory（推荐，支持反序列化） #

Gson的gson-extras库提供了RuntimeTypeAdapterFactory，专门用于处理多态类型的序列化/反序列化，它会自动添加一个类型标识字段来区分不同子类，同时保留所有字段。

步骤1：引入依赖 #

首先需要添加gson-extras的依赖（Gradle示例）：

implementation 'com.google.code.gson:gson:2.10.1'
implementation 'com.google.code.gson:gson-extras:2.10.1'

步骤2：配置Gson实例 #

import com.google.gson.Gson
import com.google.gson.GsonBuilder
import com.google.gson.runtimeTypeAdapterFactory

abstract class X<out T>(val x: T)
data class Y(val y: String = "y") : X<String>(x = "x")
class Holder(val value: X<String>)

fun main() {
    // 创建类型适配器工厂，指定父类X，并注册子类Y
    val typeAdapterFactory = runtimeTypeAdapterFactoryOf(X::class.java, "type")
        .registerSubtype(Y::class.java)
    
    // 用工厂构建Gson实例
    val gson = GsonBuilder()
        .registerTypeAdapterFactory(typeAdapterFactory)
        .create()
    
    val x = Holder(Y())
    val json = gson.toJson(x)
    println(json) 
    // 输出结果：{"value":{"type":"Y","x":"x","y":"y"}}
}

这个方案的好处是同时支持反序列化，Gson可以通过type字段识别出实际的子类类型。如果不需要type字段，可以看方案2。

方案2：自定义TypeAdapter（仅序列化场景更简洁） #

如果你只需要序列化（不需要反序列化），可以自定义一个针对X类型的TypeAdapter，强制Gson序列化对象的实际运行时类型：

import com.google.gson.Gson
import com.google.gson.GsonBuilder
import com.google.gson.TypeAdapter
import com.google.gson.stream.JsonReader
import com.google.gson.stream.JsonWriter

abstract class X<out T>(val x: T)
data class Y(val y: String = "y") : X<String>(x = "x")
class Holder(val value: X<String>)

class XTypeAdapter : TypeAdapter<X<*>>() {
    override fun write(out: JsonWriter, value: X<*>?) {
        if (value == null) {
            out.nullValue()
            return
        }
        // 直接序列化对象的实际类型
        Gson().toJson(value, value::class.java, out)
    }

    override fun read(`in`: JsonReader): X<*>? {
        // 如果需要反序列化，这里需要根据业务逻辑处理，比如默认返回Y实例
        return Gson().fromJson(`in`, Y::class.java)
    }
}

fun main() {
    val gson = GsonBuilder()
        .registerTypeAdapter(X::class.java, XTypeAdapter())
        .create()
    
    val x = Holder(Y())
    val json = gson.toJson(x)
    println(json)
    // 输出结果：{"value":{"x":"x","y":"y"}}
}

这个方案的输出完全符合你的期望，没有额外的类型标识字段，但反序列化逻辑需要你自己实现（如果需要的话）。

Gson的默认序列化策略是静态类型导向的，在多态场景下必须显式配置类型适配器，才能让Gson识别并序列化子类的独有字段。两种方案各有侧重，你可以根据是否需要反序列化来选择。

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