Jackson-databind 2.17版本中EnumSet反序列化问题解析

问题背景

在Jackson-databind从2.15.4升级到2.17.1版本后，用户发现对EnumSet的序列化/反序列化行为发生了变化。具体表现为：

1. 使用2.15.4序列化的EnumSet数据在新版本中无法反序列化
2. 使用2.17.1新序列化的EnumSet数据也无法正确反序列化

这个问题主要出现在使用默认类型信息(default typing)的场景下，特别是当EnumSet作为根对象直接序列化时。

问题现象分析

在2.15.4版本中，EnumSet的序列化结果如下：

["java.util.EnumSet<com.kze.test.TestClazz$TestEnum>",["TEST_ENUM_VALUE"]]

而在2.17.1版本中，尝试反序列化同样的JSON结构时会抛出异常：

com.fasterxml.jackson.databind.exc.MismatchedInputException: 
Unexpected token (VALUE_STRING), expected START_ARRAY: 
need Array value to contain `As.WRAPPER_ARRAY` type information for class com.kze.test.TestClazz$TestEnum

根本原因

经过分析，这个问题源于2.17版本中对EnumSet处理逻辑的修改：

1. 序列化端：EnumSetSerializer在序列化Enum值时没有包含类型信息(没有在数组第一个元素写入类型信息)
2. 反序列化端：EnumSetDeserializer却期望每个Enum值都包含类型信息(期望数组第一个元素是类型信息)

这种不对称导致了兼容性问题。特别值得注意的是，这个问题只出现在EnumSet上，普通的Set(如ImmutableCollections$Set12)不受影响，因为它们的处理逻辑是一致的。

技术细节

EnumSet在Jackson中有特殊处理，因为：

1. 它是唯一一个Jackson会序列化泛型类型信息的集合类型
2. 必须使用Enum类作为构造参数，否则无法解析实际类型
3. 在2.17版本中，反序列化端开始强制检查类型信息，但序列化端没有相应调整

解决方案与变通方法

推荐解决方案

1. 升级到最新版本：虽然2.18.2版本也存在此问题，但建议使用最新版本以获得其他修复
2. 修改Enum定义：在Enum类上添加@JsonTypeInfo(use = NONE)注解

@JsonTypeInfo(use = NONE)
public enum TestEnum {
    TEST_ENUM_VALUE
}

临时解决方案

1. 数据迁移：将数据库中的EnumSet类型改为普通Set类型
2. 自定义序列化器：实现自定义的EnumSet序列化/反序列化逻辑

最佳实践建议

1. 避免直接序列化EnumSet作为根对象，尽量将其作为其他对象的属性
2. 考虑使用普通Set替代EnumSet，除非确实需要EnumSet的特殊性能优势
3. 在升级Jackson版本时，对序列化数据格式变化保持警惕，特别是使用默认类型信息时
4. 为关键数据结构编写序列化/反序列化的单元测试，确保版本升级时的兼容性

总结

这个问题展示了Jackson处理特殊集合类型时的复杂性，特别是在默认类型信息场景下。开发者在升级Jackson版本时应当注意此类潜在的不兼容变化，特别是当应用涉及持久化序列化数据时。通过理解底层机制和采用适当的注解策略，可以有效地规避这类问题。