Kotlin多态序列化报错：Todo接口未注册序列化的解决方案求助

问题原因 #

1. 接口无法自动生成序列化器：Kotlin序列化框架无法为接口自动生成默认序列化器——接口是抽象类型，没有具体字段结构，直接给接口加@Serializable会被忽略，必须手动指定多态序列化策略。
2. 子类未注册到接口多态范围：实现接口的数据类没有被显式注册为接口的子类型，序列化框架无法识别哪些类属于Todo的多态实例，导致序列化时找不到对应子类的序列化器。

解决办法 #

Kotlin 1.6.21确实支持接口的多态序列化，但需要显式注册所有实现类，以下是两种可靠的实现方式：

方式一：使用@SerializersFor注解快速注册子类 #

直接在接口上通过注解声明所有实现类，简化配置：

// 标记接口为可序列化，并注册所有实现类
@Serializable
@SerializersFor([TodoItem::class, TodoList::class])
interface Todo

// 实现接口的数据类保持@Serializable注解
@Serializable
data class TodoItem(val id: Int, val content: String) : Todo

@Serializable
data class TodoList(val items: List<TodoItem>) : Todo

// 序列化方法
fun sendData(todo: Todo) {
    // 使用默认Json实例即可，@SerializersFor已完成注册
    val jsonString = Json.encodeToString(todo)
    // 执行发送逻辑
}

方式二：通过SerializersModule手动注册子类 #

适合需要集中管理序列化配置的场景，灵活性更高：

// 仅标记接口为可序列化
@Serializable
interface Todo

// 实现接口的数据类
@Serializable
data class TodoItem(val id: Int, val content: String) : Todo

@Serializable
data class TodoList(val items: List<TodoItem>) : Todo

// 创建序列化模块，注册Todo的所有子类
val todoSerializersModule = SerializersModule {
    polymorphic(Todo::class) {
        subclass(TodoItem::class)
        subclass(TodoList::class)
    }
}

// 配置带自定义模块的Json实例
val json = Json {
    serializersModule = todoSerializersModule
}

// 序列化方法使用配置好的Json实例
fun sendData(todo: Todo) {
    val jsonString = json.encodeToString(todo)
    // 执行发送逻辑
}

注意事项 #

• 所有实现Todo的数据类必须添加@Serializable注解，否则无法被序列化框架识别。
• 如果涉及反序列化，需要保证序列化和反序列化使用同一个Json实例（即同一个SerializersModule），避免出现类型不匹配的问题。

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