如何让Kotlin值类与Jackson、Hibernate兼容并映射为底层类型？

完全可以让Kotlin值类（inline类）与Jackson、Hibernate配合，将其直接映射为底层类型，以下是针对你遇到的问题的具体解决方法：

一、Jackson适配（解决反序列化报错） #

你碰到的反序列化错误，本质是Jackson不知道如何将字符串直接转换为Name值类。解决步骤如下：

1. 确保引入jackson-module-kotlin依赖
   这个模块专门处理Kotlin特性，包含值类的序列化/反序列化支持。

2. 给值类添加序列化/反序列化注解
   给值类的底层属性标注@JsonValue用于序列化，同时添加带@JsonCreator注解的静态工厂方法用于反序列化：

   @JvmInline
   value class Name(val value: String) {
       companion object {
           @JvmStatic
           @JsonCreator
           fun from(value: String): Name = Name(value)
       }
   
       @JsonValue
       fun rawValue(): String = value
   }
   

   配置后，Jackson序列化时会自动把Name转成字符串，反序列化时调用from方法把字符串转成Name实例，完全符合你的需求。

二、Hibernate适配（映射为数据库底层类型） #

要让Hibernate把值类当作底层类型处理，有两种常用方案：

方案1：使用AttributeConverter（通用兼容方案） #

自定义属性转换器，让Hibernate在数据库交互时自动转换Name和String：

@Converter(autoApply = true)
class NameConverter : AttributeConverter<Name, String> {
    override fun convertToDatabaseColumn(attribute: Name?): String? = attribute?.value
    override fun convertToEntityAttribute(dbData: String?): Name? = dbData?.let { Name(it) }
}

autoApply = true会让转换器自动应用到所有Name类型的字段上，实体类直接使用Name类型即可：

@Entity
class MyTable(
    @Id
    val id: Long,
    val name: Name // 自动映射为数据库的VARCHAR类型
)

方案2：Hibernate 6+原生支持 #

如果你使用Hibernate 6及以上版本，它对Kotlin值类有原生支持，无需额外转换器，只需保证值类底层类型与数据库字段类型匹配：

@JvmInline
value class Name(val value: String)

@Entity
class MyTable(
    @Id
    val id: Long,
    @Column(length = 255)
    val name: Name // 直接映射为String类型字段
)

关键注意点 #

• 编译时无警告是因为Kotlin编译器允许值类这样定义，但框架（Jackson/Hibernate）运行时需要明确的转换规则，所以必须添加上述注解或转换器。
• 确保值类构造方法为public（默认就是），且底层类型与框架预期类型匹配（比如String对应数据库VARCHAR）。

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