Fastjson2中JSONObject枚举序列化问题的分析与解决

问题背景

在Fastjson2 2.0.51版本中，开发者发现了一个关于枚举序列化的不一致性问题。当使用WriteEnumUsingOrdinal特性时，JSONObject中的枚举字段无法按预期序列化为序数(ordinal)值，而是仍然输出为枚举名称字符串。

问题表现

具体表现为两种不同的序列化行为：

1. 当枚举作为JSONObject的值时，WriteEnumUsingOrdinal特性不生效，枚举仍被序列化为名称字符串
2. 当枚举作为普通Java对象的属性时，WriteEnumUsingOrdinal特性正常工作，枚举被正确序列化为序数值

技术分析

这个问题的本质在于Fastjson2对JSONObject和普通Java对象采用了不同的序列化路径。JSONObject作为Fastjson2的核心数据结构之一，其序列化逻辑直接处理了内部的键值对，而没有完全应用外部的序列化特性。

在Fastjson2的设计中，WriteEnumUsingOrdinal特性本应统一控制所有枚举类型的序列化方式，无论它们出现在何种数据结构中。但在JSONObject的特殊处理路径中，这一特性被忽略了。

解决方案

Fastjson2开发团队在2.0.52版本中修复了这个问题。修复的核心思路是确保JSONObject的序列化过程也能正确识别和应用WriteEnumUsingOrdinal特性。

最佳实践

对于需要使用枚举序数序列化的场景，开发者应该：

1. 明确使用WriteEnumUsingOrdinal特性
2. 确保使用Fastjson2 2.0.52或更高版本
3. 注意序列化结果的一致性，无论枚举出现在JSONObject还是普通对象中

总结

这个问题的修复体现了Fastjson2对API一致性的重视。作为高性能的JSON处理库，Fastjson2不断优化其内部实现，确保各种使用场景下都能提供一致且可靠的行为。开发者在使用时应当关注版本更新，及时获取最新的功能改进和问题修复。