Fastjson2 大数值反序列化行为优化解析

背景介绍

Fastjson2 作为阿里巴巴开源的高性能 JSON 处理库，在 JSON 序列化和反序列化方面提供了丰富的功能。在实际使用过程中，开发者发现 Fastjson2 在处理大数值时的默认行为与 Fastjson1 有所不同，这可能会影响从 Fastjson1 升级到 Fastjson2 的兼容性。

问题分析

在 Fastjson1 中，当反序列化大数值时，默认会将其解析为 Long 类型。而在 Fastjson2 中，默认行为发生了变化，大数值会被解析为 BigInteger 类型，且没有提供直接的配置选项来修改这一行为。

这种差异可能导致以下问题：

1. 从 Fastjson1 升级到 Fastjson2 时，需要修改大量现有代码
2. 在某些性能敏感场景下，BigInteger 可能不如 Long 高效
3. 与现有系统的数据类型约定不一致

解决方案

Fastjson2 在 2.0.51 版本中新增了两个重要的特性来解决这个问题：

1. UseBigIntegerForInts 特性：

   • 决定当目标类型为泛型（Object 或 Number）时，是否将 JSON 整型数字反序列化为 BigInteger
   • 默认禁用，此时会使用最紧凑的整型类型（Integer、Long 或 BigInteger）来优化效率

2. UseLongForInts 特性：

   • 决定当目标类型为泛型时，如何处理适合 32 位有符号整数范围的数值
   • 启用时，会反序列化为 Long 类型
   • 禁用时（默认），会使用最紧凑的 Integer 类型
   • 注意：如果启用了 UseBigIntegerForInts，它将优先于此设置

使用方法

开发者可以通过以下方式配置这些特性：

// 全局配置
JSON.config(JSONReader.Feature.UseLongForInts);

// 单次解析配置
JSON.parseObject(jsonStr, Object.class, JSONReader.Feature.UseLongForInts);

技术建议

1. 升级兼容性：从 Fastjson1 升级到 Fastjson2 时，建议启用 UseLongForInts 特性以保持行为一致
2. 性能考虑：在不需要 BigInteger 的场景下，使用 Long 或 Integer 可以获得更好的性能
3. 类型安全：明确指定目标类型（如 Long.class）比依赖自动类型推断更可靠
4. 数值范围：注意数值范围，避免在配置为较小类型时发生溢出

总结

Fastjson2 通过新增的 UseBigIntegerForInts 和 UseLongForInts 特性，为开发者提供了更灵活的大数值处理方式。这一改进不仅解决了与 Fastjson1 的兼容性问题，还让开发者能够根据具体场景选择最适合的数据类型，在功能完整性和性能之间取得平衡。