如何让Jackson JSON反序列化器在多字段共存时优先选指定字段？

当你使用@JsonCreator构造器配合@JsonAlias时，若JSON中同时存在原字段和别名字段，Jackson会尝试多次绑定同一个构造器参数，导致冲突报错。以下是几种适配你需求（优先使用name，仅当name不存在时才用title）的解决方案：

方案一：自定义反序列化器（推荐，适用于多字段场景） #

这种方法逻辑清晰，能灵活处理多个字段的优先级判断，尤其适合你提到的四个相关字段的场景。

1. 编写自定义反序列化器：

class MyClassDeserializer : StdDeserializer<MyClass>(MyClass::class.java) {
    override fun deserialize(p: JsonParser, ctxt: DeserializationContext): MyClass {
        val jsonNode = p.codec.readTree<JsonNode>(p)
        // 优先取name，不存在则取title
        val name = jsonNode.get("name")?.asText() ?: jsonNode.get("title")?.asText()
            ?: throw ctxt.mappingException("必须提供name或title字段")
        
        // 若有其他字段，按同样逻辑处理，例如：
        // val age = jsonNode.get("age")?.asInt() ?: jsonNode.get("years")?.asInt() ?: ...
        return MyClass(name)
    }
}

2. 在数据类上指定反序列化器：

@JsonDeserialize(using = MyClassDeserializer::class)
data class MyClass(val name: String)

此方案无论JSON中只存在name、只存在title，还是两者同时存在，都会优先使用name的值，完全匹配你的需求。

方案二：构造器参数合并判断（适用于字段较少的场景） #

如果字段数量不多，可以通过构造器接收所有可能的字段，在构造逻辑中手动判断优先级：

data class MyClass(val name: String) {
    @JsonCreator
    constructor(
        @JsonProperty("name") name: String?,
        @JsonProperty("title") title: String?
    ) : this(name ?: title ?: throw IllegalArgumentException("必须提供name或title字段"))
}

这种方法不需要额外编写反序列化器，但当字段和别名较多时，构造器参数会变得冗长，维护成本较高。

方案三：Setter注入配合优先级判断 #

通过Setter方法控制赋值逻辑，仅当目标字段未赋值时才使用别名的值：

data class MyClass(var name: String?) {
    // 无参构造用于Jackson反射实例化
    @JsonCreator
    constructor() : this(null)

    @JsonSetter("title")
    fun setTitle(title: String) {
        // 仅当name为空时，才用title赋值
        if (name.isNullOrEmpty()) {
            name = title
        }
    }
}

注意：这种方法需要将name设为var，并且需要提供无参构造，可能会破坏data class的不可变性，需根据实际场景权衡。

你的现有ObjectMapper配置已注册Kotlin模块，无需额外调整，以上方案均可直接兼容。

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