KTOR反序列化含嵌套对象的POST请求体失败问题排查

核心问题分析 #

你遇到的反序列化失败，主要是两个原因：

1. JSON字段与数据类字段命名不匹配：请求体里的car_type是蛇形命名，但CarModel里的属性是驼峰式的carType，Kotlinx Serialization默认不会自动转换这种命名差异。
2. JSON存在尾随逗号：示例请求体中每个cars元素末尾都有多余的逗号，默认的JSON解析器会认为这是语法错误。

具体修复步骤 #

1. 解决字段命名映射问题

有两种方式可以处理命名不一致：

• 方式一：单个字段指定映射
  给CarModel的carType字段添加@SerialName注解，明确对应JSON里的字段名：

@Serializable
data class CarModel(
    val uuid: String? = null,
    @SerialName("car_type")
    val carType: String,
    val name: String
)

• 方式二：全局配置蛇形命名策略
  如果你的接口大量使用蛇形命名，可以在Ktor的序列化配置中全局开启蛇形命名转换，这样所有驼峰式的属性都会自动匹配蛇形的JSON字段：

install(ContentNegotiation) {
    json(Json {
        ignoreUnknownKeys = true // 忽略请求体中未定义的字段
        isLenient = true // 允许宽松的JSON语法（比如尾随逗号）
        namingStrategy = JsonNamingStrategy.SnakeCase
    })
}

2. 允许JSON尾随逗号

在上面的全局JSON配置中，已经通过isLenient = true开启了宽松模式，解析器会自动忽略请求体中的尾随逗号，避免语法错误。

3. 确认依赖配置正确

确保你的项目中已经添加了Kotlinx Serialization插件和Ktor序列化相关依赖：

// build.gradle.kts 示例配置
plugins {
    kotlin("jvm") version "1.9.20"
    kotlin("plugin.serialization") version "1.9.20"
}

dependencies {
    implementation("io.ktor:ktor-server-content-negotiation-jvm:2.3.7")
    implementation("io.ktor:ktor-serialization-kotlinx-json-jvm:2.3.7")
}

验证修复后的请求体 #

去掉多余的尾随逗号（或者依赖宽松模式自动忽略），请求体可以正常解析：

{
    "name": "Manufacturer 1",
    "cars": [
        {
            "car_type": "Sedan",
            "name": "Car 1"
        },
        {
            "car_type": "Sedan",
            "name": "Car 2"
        }
    ]
}

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