如何在REST Assured中将Kotlin数据类转为请求参数Map？

REST Assured的params()默认只接受Map类型，但我们可以通过对象转Map的转换逻辑，实现像body()那样直接传入数据类实例的效果，下面是几种具体实现方式：

1. 手动转换数据类为Map（基础方案） #

借助序列化库（比如Jackson或Kotlinx Serialization），将数据类实例转换为键值对Map，再传入params()。以Jackson为例：

首先确保项目引入Jackson Kotlin模块依赖，然后编写转换扩展函数：

import com.fasterxml.jackson.databind.ObjectMapper
import com.fasterxml.jackson.module.kotlin.registerKotlinModule

// 全局初始化ObjectMapper，注册Kotlin模块支持
val objectMapper = ObjectMapper().registerKotlinModule()

// 扩展函数：将任意对象转为请求参数Map
fun Any.toParamMap(): Map<String, Any> {
    return objectMapper.convertValue(this, Map::class.java) as Map<String, Any>
}

使用时直接调用扩展函数转换：

val person = Person("John", "Locke", 66)

Given {
    params(person.toParamMap())
} When {
    post("/api/example")
}

如果你的数据类使用了@JsonProperty注解指定参数名，Jackson会自动识别注解中的名称作为Map的键，和body()的序列化行为一致。

2. 扩展REST Assured的params()方法（更优雅的方案） #

通过扩展REST Assured的RequestSpecification，让params()直接支持接收任意对象，内部自动完成转换：

import io.restassured.specification.RequestSpecification

// 扩展RequestSpecification，添加支持对象的params方法
fun RequestSpecification.params(obj: Any): RequestSpecification {
    val paramMap = objectMapper.convertValue(obj, Map::class.java) as Map<String, Any>
    return this.params(paramMap)
}

之后就可以像使用body()一样直接传入数据类实例：

val person = Person("John", "Locke", 66)

Given {
    params(person) // 直接传入实例，内部自动转Map
} When {
    post("/api/example")
}

注意事项 #

• 如果数据类包含嵌套对象，转换后的Map会保留嵌套结构，此时需要根据后端接口的参数格式要求，决定是否要将嵌套结构展开（比如用parent.child的键名格式），可以在转换逻辑中额外处理。
• 如果使用Kotlinx Serialization而非Jackson，只需替换转换逻辑为Kotlinx的序列化API，核心思路一致。

内容的提问来源于stack exchange，提问作者ᴜsᴇʀ