本文介绍如何通过自定义 TypeAdapterFactory 实现 Kotlin 中泛型 Optional 类型的条件序列化：当 isPresent 为 false 时完全省略字段，即使启用 serializeNulls()；同时说明 Gson 在 Kotlin 泛型与缺失字段处理上的固有限制。
本文介绍如何通过自定义 typeadapterfactory 实现 kotlin 中泛型 optional
在使用 Gson 序列化 Kotlin 数据类时，若需精确控制“可选字段”（presence-aware）而非简单“可空字段”（nullable），原生 T? 类型无法满足需求——它仅表达“可能为 null”，却无法区分“字段未提供”与“字段显式设为 null”。此时，自定义泛型容器如 Optional
✅ 核心思路：拦截序列化过程，按 isPresent 动态决策
关键在于实现 TypeAdapterFactory，针对 Optional
以下是生产就绪的 Kotlin 实现：
class OptionalTypeAdapterFactory : TypeAdapterFactory {
override fun <t : any> create(gson: Gson, type: TypeToken<t>): TypeAdapter<t>? {
val rawType = type.rawType
if (rawType !is Class || rawType != Optional::class.java) {
return null
}
// 获取泛型参数 T 的 TypeAdapter（支持嵌套泛型，如 Optional<int>）
val valueType = (type.type as? ParameterizedType)?.actualTypeArguments?.get(0)
?: Any::class.java
val valueAdapter = gson.getAdapter(TypeToken.get(valueType))
@Suppress("UNCHECKED_CAST")
return object : TypeAdapter<optional>>() {
override fun write(out: JsonWriter, value: Optional?) {
if (value == null || !value.isPresent) {
// 完全跳过字段：不写 key，不写 value
return
}
// isPresent == true → 序列化 value 字段内容（非整个 Optional 对象）
valueAdapter.write(out, value.value)
}
override fun read(`in`: JsonReader): Optional? {
// 注意：反序列化逻辑需谨慎设计（见下文说明）
throw UnsupportedOperationException("Deserialization of Optional is not covered here")
}
} as TypeAdapter<t>
}
}</t></optional></int></t></t></t>
使用方式（注册到 GsonBuilder）：
val gson = GsonBuilder()
.serializeNulls() // 即使开启此选项，Optional 未 present 仍被跳过
.registerTypeAdapterFactory(OptionalTypeAdapterFactory())
.create()
// 示例数据
val request = SimpleRequest(
a = 42,
b = Optional(isPresent = false, value = "ignored"),
c = Optional(isPresent = true, value = "Hello"),
d = null,
e = Optional(isPresent = true, value = null) // → 序列化为 "e": null
)
println(gson.toJson(request))
// 输出：{"a":42,"c":"Hello","d":null,"e":null}
// 注意：b 字段完全不存在，c 直接输出字符串值，e 因 isPresent=true 且 value=null 而输出 null
⚠️ 重要注意事项与局限性
- serializeNulls() 不影响 Optional 跳过逻辑：本方案通过主动跳过 JsonWriter.name() 实现字段剔除，因此与全局 serializeNulls() 设置正交，互不干扰。
-
反序列化需额外处理：上述示例中 read() 抛出异常，因 Gson 对缺失字段无原生回调机制（GitHub Issue #1005）。若需反序列化，推荐：
- 使用 @JsonAdapter 为具体字段指定更精细的 TypeAdapter；
- 或切换至更 Kotlin-Friendly 的库（如 Moshi + Kotlin Code Gen、Jackson with Kotlin Module），它们对 Optional/Result/默认参数等有更完善支持。
- Gson 的 Kotlin 支持短板：Gson 主要面向 Java 设计，对 Kotlin 的空安全、默认参数、泛型实化等特性支持有限（参见 Issue #1657）。在复杂 Kotlin 项目中，长期建议评估替代方案。
-
类型擦除安全：代码中通过 ParameterizedType 提取泛型 T 并委托给 Gson 内置适配器，确保 Optional
、Optional 等均能正确处理。
✅ 总结
通过自定义 TypeAdapterFactory，你可以在 Gson 中优雅实现 Optional
