使用Kotlin数据类构建RestTemplate请求JSON时遇保留关键字问题

这个问题我之前也碰到过，其实完全不用修改RestTemplate或者纠结toString方法，利用JSON序列化框架的注解就能轻松搞定！

核心解决方案：用序列化注解映射字段名 #

RestTemplate默认依赖Jackson来处理JSON的序列化/反序列化，我们可以通过Jackson的@JsonProperty注解，让Kotlin数据类里的非保留字属性，在序列化后自动变成API要求的"object"字段。

具体实现步骤 #

1. 确认Jackson依赖：Spring Boot项目默认已经包含jackson-databind依赖，无需额外添加；如果是普通Spring项目，确保依赖已引入。
2. 定义带注解的数据类：

import com.fasterxml.jackson.annotation.JsonProperty

data class RequestClass(
    @JsonProperty("object") // 明确指定序列化后的JSON字段名为"object"
    val obj: Any? // 用非保留字作为Kotlin属性名，比如obj
    // 其他需要的属性可以继续添加
)

3. 正常使用RestTemplate发起请求：

val restTemplate = RestTemplate()
val requestBody = RequestClass(obj = yourActualDataObject) // 传入实际要发送的数据
val response = restTemplate.postForEntity(
    "https://your-target-api.com/endpoint",
    requestBody,
    YourResponseType::class.java
)

为什么重写toString没用？ #

你之前尝试重写toString方法无效，是因为RestTemplate在生成请求JSON时，根本不会调用toString方法——它是通过Jackson的序列化机制直接将对象转换为JSON字符串的。toString只是用于日志打印或调试，完全不影响实际的请求内容。

备选方案（如果用Gson做序列化器） #

如果你的项目配置了Gson作为RestTemplate的序列化工具，可以改用Gson的@SerializedName注解：

import com.google.gson.annotations.SerializedName

data class RequestClass(
    @SerializedName("object")
    val obj: Any?
)

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