如何使用Ktor Location API将JSON反序列化为泛型Map对象

@Location 注解的核心作用是定义路由规则、自动绑定路径参数和查询参数，和请求体的JSON反序列化是两个独立流程，你之前的写法混淆了两者的参数来源，以下是可直接运行的实现方案：

最优实现方案（保留原有Map反序列化逻辑） #

该方案和你之前普通Routing的实现效果完全一致，仅用@Location做路由定义，不需要修改反序列化逻辑：

import io.ktor.server.locations.*

// 仅用于路由匹配，不需要额外属性，有路径/查询参数时直接加属性即可
@Location("/books")
data class BookPostRoute()

fun Application.bookModule() {
    // 必须先安装Locations插件，否则路由不生效
    install(Locations)
    
    routing {
        post<BookPostRoute> {
            // 直接接收请求体为Map，和你之前普通路由的用法完全一致
            val request = call.receive<Map<String, Any>>()
            // 此处request实际类型依然是com.google.gson.internal.LinkedTreeMap
            // 后续业务逻辑
        }
    }
}

可选封装方案（将Map整合到Location类） #

如果有需求要把请求体Map和路由参数封装到同一个类中，可以用以下写法：

import io.ktor.server.locations.*

@Location("/books")
data class BookRequest(
    // 路径/查询参数直接在此定义，插件会自动绑定
    val author: String? = null,
    val body: Map<String, Any> = emptyMap()
)

fun Application.bookModule() {
    install(Locations)
    
    routing {
        post<BookRequest> { routeParams ->
            // routeParams是Locations插件自动绑定的路径/查询参数实例
            // 手动接收请求体赋值到body属性
            val fullRequest = routeParams.copy(body = call.receive())
            // 后续通过fullRequest.body访问Map数据
        }
    }
}

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