Kotlin数据类在Spring Data Rest中URI关联反序列化失败问题

这个问题我在项目里也踩过坑，本质是Kotlin data class的构造函数特性和Spring Data Rest的关联反序列化逻辑不兼容导致的。

为什么Data Class会报错？ #

Kotlin的data class默认会根据主构造函数里的所有属性生成对应的构造方法，但它没有默认的空参构造函数。而Spring Data Rest在处理关联URI（比如通过POST请求传递"post": "/posts/1"这种格式）时，需要先实例化实体对象，再通过setter方法把URI转换为关联的实体。但data class的主构造函数里的post参数是Post?类型，无法直接接收String类型的URI，Spring找不到合适的构造方式，就会抛出no String-argument constructor/factory method to deserialize from String value这个错误。

而普通Kotlin类如果没有显式定义构造函数，默认会生成空参构造函数，Spring可以先实例化对象，再通过反射调用setPost方法完成关联，所以能正常工作。

解决方案：给Data Class添加空参构造函数 #

最优雅的方式是使用Kotlin的noarg插件，它可以自动给标注了特定注解的类生成空参构造函数，完美保留data class的所有特性（equals、hashCode、toString等）。

步骤1：配置插件（以Gradle Kotlin DSL为例）

在build.gradle.kts中添加插件依赖：

plugins {
    kotlin("jvm") version "1.9.20" // 替换为你的Kotlin版本
    kotlin("plugin.jpa") version "1.9.20"
    kotlin("plugin.noarg") version "1.9.20"
}

noArg {
    // 指定给所有@Entity注解的类生成空参构造
    annotation("javax.persistence.Entity")
}

步骤2：修改你的Data Class

只需要保留原有的data class代码即可（插件会自动生成空参构造），如果想更明确可以加上@NoArg注解：

@Entity
@NoArg // 可选，插件已配置按@Entity生成时可以省略
data class Comment(
    @Id @GeneratedValue(strategy = GenerationType.IDENTITY)
    var id: Long = 0,
    var author: String? = null,
    var content: String? = null,
    @ManyToOne
    var post: Post? = null
)

其他可选方案（不推荐） #

• 手动添加空参构造：在data class里手动写一个空参构造，但这样会破坏data class的自动生成逻辑，需要自己维护equals/hashCode等方法，非常麻烦。
• 将关联属性移出主构造：把post属性移到类体中，不在主构造里声明，这样data class的主构造就不包含它，Spring可以通过setter设置。但这样会导致data class的equals/hashCode不包含post属性，可能不符合业务预期。

这样修改后，Spring Data Rest就能正常处理通过URI关联实体的操作了。

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