Spring Data映射异常：抽象类继承致字段映射歧义如何解决？

问题原因 #

你的代码中，UpdateObjectCommand作为ObjectCommand的子类，在主构造函数中override了父类的eventType属性。由于Kotlin data class的特性，这个override的属性会在子类中生成一个独立的字段，导致Spring Data MongoDB扫描时，同时识别到父类和子类的eventType字段，两者都要映射到数据库的eventType字段，从而触发MappingException歧义错误。

解决方案 #

方案一：避免子类override父类属性（推荐） #

修改UpdateObjectCommand的构造函数，不要override父类的eventType，而是直接将参数传递给父类构造函数。这样子类不会生成独立的eventType字段，仅使用父类的字段进行映射：

abstract class ObjectCommand(
    open var eventType: EventType?
)

@Document(collection = "COMMAND")
data class UpdateObjectCommand(
    val description: String?,
    eventType: EventType?
) : ObjectCommand(eventType)

方案二：标记子类override属性为非持久化 #

如果必须保留override语法（比如业务需求），可以在子类的eventType上添加@Transient注解，让Spring Data MongoDB忽略子类的这个字段，仅使用父类的eventType进行数据库映射：

import org.springframework.data.mongodb.core.mapping.Field
import org.springframework.data.annotation.Transient

abstract class ObjectCommand(
    @Field("eventType") // 明确指定数据库字段名
    open var eventType: EventType?
)

@Document(collection = "COMMAND")
data class UpdateObjectCommand(
    val description: String?,
    @Transient // 标记该字段不参与持久化
    override var eventType: EventType?
) : ObjectCommand(eventType)

方案三：统一指定字段映射（备选） #

在父类和子类的eventType上都添加@Field注解，明确指定映射到同一个数据库字段。不过这种方式本质上还是保留了两个字段，只是强制映射到同一列，不如前两种方案简洁：

import org.springframework.data.mongodb.core.mapping.Field

abstract class ObjectCommand(
    @Field("eventType")
    open var eventType: EventType?
)

@Document(collection = "COMMAND")
data class UpdateObjectCommand(
    val description: String?,
    @Field("eventType")
    override var eventType: EventType?
) : ObjectCommand(eventType)

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