Ktor中call.receiveParameters()调用失败的正确解决方法

问题本质 #

call.receiveParameters() 是Ktor专门用于解析application/x-www-form-urlencoded类型表单请求体的API，但你前端通过Axios发送的是JSON格式请求（默认Content-Type为application/json），两者格式不匹配，导致Ktor找不到对应的转换规则，抛出转换失败错误。

你能通过call.receive<Map<String,String>>()正常读取，是因为已配置的Content Negotiation插件包含JSON解析器，可将JSON请求体直接转换为Map类型。

解决方法 #

根据业务需求选择以下任意一种方案：

方案1：保持前端JSON请求格式（推荐）

方法1：用数据类接收（类型安全）

先定义与请求结构匹配的数据类：

data class RequestParams(
    val a: String,
    val b: String
)

然后在路由中直接接收：

val params = call.receive<RequestParams>()
// 直接使用 params.a、params.b 调用参数

这种方式符合Kotlin类型安全特性，便于后续参数校验和功能扩展。

方法2：将Map转换为Parameters（兼容原有操作习惯）

如果确实需要使用Parameters类型对象，可将接收的Map转换：

val paramsMap = call.receive<Map<String, String>>()
val params = Parameters.build {
    paramsMap.forEach { (key, value) ->
        append(key, value)
    }
}
// 现在可像操作普通Parameters一样使用params

方案2：修改前端为表单格式发送请求

若希望后端继续使用call.receiveParameters()，需调整Axios请求，以表单格式传递数据：

axios.post(
    `http://127.0.0.1:8080/api/...`,
    new URLSearchParams({
        a: "1",
        b: "2"
    }),
    {}
)

此时前端请求的Content-Type会自动变为application/x-www-form-urlencoded，后端即可正常用call.receiveParameters()读取参数。

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