Fastjson2枚举类反序列化负数问题解析与解决方案

问题背景

在Java开发中，枚举类型(Enum)是一种常用的数据类型，用于定义一组固定的常量。Fastjson2作为阿里巴巴开源的高性能JSON处理库，在序列化和反序列化过程中对枚举类型提供了良好的支持。然而，近期发现当枚举类中包含负数值时，Fastjson2在反序列化过程中会出现异常。

问题现象

当使用Fastjson2反序列化包含负数值的枚举类时，系统会抛出"JSONException: No enum ordinal"异常。例如，对于以下枚举定义：

enum EnumClass {
    A(1),
    NEGATIVE_ONE(-1);
    
    private final int code;
    
    EnumClass(int code) {
        this.code = code;
    }
    
    public int getCode() {
        return code;
    }
}

尝试反序列化JSON字符串{"code": -1}时，Fastjson2无法正确处理负数值，导致反序列化失败。

技术分析

根本原因

Fastjson2内部在处理枚举类型时，默认会尝试将JSON值作为枚举的序数(ordinal)来处理。枚举的ordinal是其在定义中的位置索引，从0开始的正整数。当遇到负数值时，Fastjson2会检查这个值是否在有效范围内，由于负值显然不在有效范围内，因此抛出异常。

源码层面

在Fastjson2的ObjectReaderImplEnum类中，存在对枚举ordinal的检查逻辑：

if (ordinal < 0 || ordinal >= enumConstants.length) {
    throw new JSONException("No enum ordinal " + enumType.getName() + "." + ordinal);
}

这段代码明确拒绝了负数值，导致包含负数的枚举无法正常反序列化。

解决方案

官方修复

Fastjson2开发团队在2.0.50版本中修复了这个问题。新版本改进了枚举类型的反序列化逻辑，现在可以正确处理包含负数值的枚举类。建议开发者升级到2.0.50或更高版本。

临时解决方案

对于暂时无法升级的项目，可以采用自定义反序列化器的方式解决：

ParserConfig.getGlobalInstance().putDeserializer(EnumClass.class, new ObjectDeserializer() {
    @Override
    public <T> T deserialze(DefaultJSONParser parser, Type type, Object fieldName) {
        Integer intValue = parser.parseObject(int.class);
        return (T) Arrays.stream(EnumClass.values())
                .filter(it -> it.getCode() == intValue)
                .findFirst()
                .orElseThrow(() -> new IllegalArgumentException("No enum value: " + intValue));
    }
});

这种方法通过自定义反序列化逻辑，直接比较枚举的code值而非依赖ordinal，从而支持负数值。

最佳实践

1. 版本升级：优先考虑升级到Fastjson2 2.0.50或更高版本，这是最彻底的解决方案。

2. 枚举设计：在设计枚举类时，如果使用自定义数值而非默认ordinal，建议：

   • 提供静态的valueOf(int code)方法
   • 保持数值的唯一性
   • 考虑边界情况处理

3. 测试覆盖：对于包含特殊值(如负数)的枚举类型，应增加相应的测试用例，确保序列化和反序列化的正确性。

总结

Fastjson2对枚举类型的支持总体上是完善的，但在处理特殊场景如负数值时存在局限性。通过理解其内部机制，开发者可以选择合适的解决方案。官方在2.0.50版本中的修复为这一问题提供了标准解决方案，体现了开源项目对社区反馈的积极响应。在日常开发中，合理设计枚举类并保持依赖库的及时更新，可以有效避免类似问题的发生。