Kotlin使用@Serializable时报TaskPayload未在EventPayload域注册错误

1. 检查版本兼容性 #

• 确保项目中 Kotlin 编译器插件版本与 kotlinx-serialization 核心库版本完全兼容，二者版本不匹配会触发识别误报。
  比如 Kotlin 1.9.x 对应 serialization 库 1.6.x 版本，Kotlin 1.8.x 对应 serialization 库 1.5.x 版本。
• 确认模块级 build.gradle 已正确引入序列化插件和依赖：

  // 插件声明
  plugins {
      id("org.jetbrains.kotlin.plugin.serialization")
  }
  // 依赖声明
  dependencies {
      implementation("org.jetbrains.kotlinx:kotlinx-serialization-json:匹配Kotlin版本的版本号")
  }
  

2. 检查密封类子类的文件位置 #

kotlinx-serialization 1.4.0 之前的版本仅支持自动扫描和密封类同文件的子类，你当前将 TaskPayload 放在独立文件中，旧版本库无法自动识别，可选择两种方案解决：

• 将所有继承自 EventPayload 的子类移动到 EventPayload.kt 同一个文件中
• 升级 kotlinx-serialization 库到 1.4.0 及以上版本，新版本支持跨文件扫描同一模块下的密封类子类

注意：如果子类定义在其他独立模块中，无论序列化库版本，都需要手动注册序列化器。

3. 显式注册多态序列化器（通用兜底方案） #

如果上述方案仍未解决，可直接在 Json 序列化配置中手动注册子类，跳过自动扫描逻辑，实现方式如下：

val jsonConfig = Json {
    serializersModule = SerializersModule {
        polymorphic(EventPayload::class) {
            subclass(TaskPayload::class)
            // 后续新增其他EventPayload子类，都在这里补充注册即可
        }
    }
}

后续所有序列化/反序列化操作都使用上述配置的 jsonConfig 对象执行即可。

4. 检查注解配置 #

确认 EventPayload 上的 @Serializable 注解没有手动指定 with 参数，手动指定序列化器会覆盖密封类默认的多态序列化逻辑，导致子类识别失败。

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