Fastjson2 中 Decimal128 转 Double 问题的解决方案

背景介绍

在 Java 开发中，Fastjson2 是一个广泛使用的高性能 JSON 处理库。当它与 MongoDB 数据库结合使用时，开发者可能会遇到一个特定的类型转换问题：从 MongoDB 的 Decimal128 类型转换为 Java 的 Double 类型时出现类型转换异常。

问题分析

这个问题的根源在于数据流转过程中的类型转换链：

1. 首先，Java 对象通过 Fastjson2 序列化为 JSON 字符串并通过消息队列传输
2. 接收端使用 Fastjson2 将 JSON 字符串反序列化为 JSONObject 对象
3. Fastjson2 默认将带有小数点的数值反序列化为 BigDecimal 类型
4. 当这些数据存储到 MongoDB 时，BigDecimal 会自动转换为 MongoDB 的 Decimal128 类型
5. 从 MongoDB 读取数据时，Fastjson2 需要将 Decimal128 转换回 Java 的 Double 类型

问题的关键在于 Fastjson2 的类型转换系统中缺少从 org.bson.types.Decimal128 到 java.lang.Double 的直接转换支持，导致类型转换失败。

解决方案

为了解决这个问题，我们需要在 Fastjson2 的类型转换系统中增加对 Decimal128 到 Double 转换的支持。具体实现思路如下：

1. 在 TypeUtils.cast 方法中增加特定条件判断
2. 当检测到源类型是 Decimal128 且目标类型是 Double 时
3. 通过 ObjectWriter 获取 Decimal128 的原始值
4. 使用已有的类型转换器将原始值转换为 Double

这种解决方案的优势在于：

• 保持了 Fastjson2 原有的类型转换机制
• 只针对特定场景增加最小化的修改
• 不影响其他类型转换的正常工作

实现细节

在技术实现上，关键点在于：

1. 识别 Decimal128 类型对象
2. 获取 Decimal128 的原始数值表示
3. 利用 Fastjson2 现有的类型转换机制完成最终转换

这种实现方式既解决了特定问题，又保持了代码的整洁性和可维护性。

最佳实践

对于开发者来说，在使用 Fastjson2 与 MongoDB 交互时，建议：

1. 明确数据模型中数值字段的类型
2. 对于可能涉及 Decimal128 转换的场景，考虑升级到支持此转换的 Fastjson2 版本
3. 在自定义类型转换时，可以参考此解决方案的实现思路

总结

Fastjson2 2.0.50 版本已经包含了这个问题的修复。通过增加对 Decimal128 到 Double 的类型转换支持，解决了 MongoDB 与 Fastjson2 集成时的一个常见问题。这个改进展示了 Fastjson2 团队对实际开发场景的深入理解和对开发者需求的快速响应能力。

对于开发者来说，理解这种类型转换的机制有助于更好地处理 JSON 数据与各种数据存储系统之间的交互，提高应用的稳定性和可靠性。