如何解决Java 21 SequencedSet与Jackson反序列化兼容问题？

Jackson抛出InvalidDefinition错误的核心原因是：它无法直接反序列化接口类型的集合——SequencedSet是Java 21引入的有序集合接口，Jackson没有默认绑定对应的具体实现类，不知道该实例化哪种类型来填充数据。

下面是几种可行的解决方案：

方案1：给字段添加@JsonDeserialize注解指定实现类 #

直接在SequencedSet字段上标注@JsonDeserialize，指定一个具体的SequencedSet实现类（比如LinkedHashSet，它是JDK中最常用的SequencedSet实现）：

class MyClass {
    @JsonDeserialize(as = LinkedHashSet.class)
    private SequencedSet<UUID> ids;

    public SequencedSet<UUID> getIds() {
        return ids;
    }

    public void setIds(SequencedSet<UUID> ids) {
        this.ids = ids;
    }
}

方案2：全局配置Jackson默认实现类 #

如果项目中有多处使用SequencedSet，可以全局配置ObjectMapper，给SequencedSet指定默认的实现类，避免重复加注解：

ObjectMapper objectMapper = new ObjectMapper();
// 给SequencedSet接口指定默认实例化的实现类
objectMapper.configOverride(SequencedSet.class)
    .setDefaultImpl(LinkedHashSet.class);

方案3：自定义反序列化器（按需使用） #

如果需要自定义SequencedSet的初始化逻辑（比如特定排序规则、自定义元素校验），可以编写自定义反序列化器：

public class SequencedSetDeserializer extends JsonDeserializer<SequencedSet<UUID>> {
    @Override
    public SequencedSet<UUID> deserialize(JsonParser p, DeserializationContext ctxt) throws IOException {
        // 读取JSON数组并转换为LinkedHashSet（或自定义实现）
        List<UUID> uuidList = p.readValueAs(new TypeReference<List<UUID>>() {});
        return new LinkedHashSet<>(uuidList);
    }
}

然后在字段上标注使用该反序列化器：

@JsonDeserialize(using = SequencedSetDeserializer.class)
private SequencedSet<UUID> ids;

你临时改用LinkedHashSet可行的原因是：它是具体类，Jackson能直接识别并实例化，同时它实现了SequencedSet接口，完全兼容原字段的接口类型定义。

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