Ktor调用call.respond返回含Int值的响应时抛出序列化异常

在Ktor项目中开发接口时，通过call.respond返回包含Int类型值的Map响应会触发报错，将Map内所有值都改为String类型即可正常响应。
复现问题的接口代码：

post("/employee") {
    call.respond(mapOf("hey" to "Hey","if" to 1))
}

运行时抛出的异常日志如下：

java.lang.IllegalStateException: Serializing collections of different element types is not yet supported. Selected serializers: [kotlin.String, kotlin.Int]
at io.ktor.serialization.kotlinx.SerializerLookupKt.elementSerializer(SerializerLookup.kt:45)
at io.ktor.serialization.kotlinx.SerializerLookupKt.guessSerializer(SerializerLookup.kt:29)
at io.ktor.serialization.kotlinx.KotlinxSerializationBase.serialize$ktor_serialization_kotlinx(KotlinxSerializationBase.kt:34)

核心报错提示：暂不支持序列化包含不同元素类型的集合，当前选中的序列化器为[kotlin.String, kotlin.Int]

Ktor默认集成的kotlinx.serialization序列化组件，在处理泛型类型被擦除的Map<String, Any>结构时，无法自动为不同类型的值匹配对应序列化器，当前版本未内置混合类型集合/Map的自动序列化能力，检测到Map值同时存在String、Int两种类型时就会直接抛出异常。

• 方案1（推荐）：定义明确的可序列化数据类承载返回值，避免直接返回无明确类型约束的Map。
  首先添加数据类定义，添加序列化注解：

  import kotlinx.serialization.Serializable
  
  @Serializable
  data class EmployeeResponse(
      val hey: String,
      // 关键字if做字段名需要加反引号转义
      val `if`: Int
  )
  

  接口中返回数据类实例即可：

  post("/employee") {
      call.respond(EmployeeResponse(hey = "Hey", `if` = 1))
  }
  

• 方案2：如果业务必须返回动态结构的Map，可显式使用JsonElement类型包装值，让序列化器统一按JSON节点处理。
  先确保内容协商配置的Json实例正常加载：

  import io.ktor.serialization.kotlinx.json.*
  import io.ktor.server.plugins.contentnegotiation.*
  import kotlinx.serialization.json.Json
  
  install(ContentNegotiation) {
      json(Json {
          prettyPrint = true
          encodeDefaults = true
      })
  }
  

  接口返回时用JsonPrimitive包装不同类型的值，构造明确类型为Map<String, JsonElement>的返回对象：

  import kotlinx.serialization.json.JsonPrimitive
  
  post("/employee") {
      val responseMap = mapOf(
          "hey" to JsonPrimitive("Hey"),
          "if" to JsonPrimitive(1)
      )
      call.respond(responseMap)
  }
  

• 方案3：简单临时场景可直接将Map内所有值统一转为String类型返回，和之前验证可正常运行的写法逻辑一致，该方式需要前端/调用方自行做字段类型转换，不推荐在正式业务场景大规模使用。

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