Apache Fury 序列化 Fastjson 1.x 版本 JSONObject 列表时的 ClassCastException 问题分析

在 Apache Fury 0.6.0-SNAPSHOT 版本中，当尝试序列化包含 Fastjson 1.x 版本 JSONObject 列表的对象时，会遇到一个 ClassCastException 异常。这个问题特别出现在使用 Fastjson 1.2.70 版本时，而 Fastjson 2.x 版本则能正常工作。

问题现象

开发者在使用 Fury 序列化一个包含 List 字段的 DemoResponse 对象时，遇到了以下异常：

java.lang.ClassCastException: org.apache.fury.serializer.collection.MapSerializers$StringKeyMapSerializer cannot be cast to org.apache.fury.serializer.collection.MapSerializers$JDKCompatibleMapSerializer

这个异常表明 Fury 在内部尝试将一个字符串键映射序列化器转换为 JDK 兼容映射序列化器时失败了。

技术背景

Apache Fury 是一个高性能的序列化框架，它通过生成特定于类的序列化代码来优化性能。对于集合类型的序列化，Fury 提供了专门的序列化器来处理不同的集合实现。

Fastjson 1.x 中的 JSONObject 实现了 Map 接口，但它的具体实现与标准 JDK Map 实现有所不同。Fury 在处理这种第三方 Map 实现时，需要选择合适的序列化策略。

问题根源

问题的根本原因在于 Fury 的序列化器选择逻辑对于 Fastjson 1.x 的 JSONObject 处理不够完善。具体来说：

1. Fury 检测到 JSONObject 是一个 Map 实现，尝试为其选择适当的 Map 序列化器
2. 在序列化器选择过程中，Fury 错误地将 StringKeyMapSerializer 强制转换为 JDKCompatibleMapSerializer
3. 这种类型转换是不合法的，因为这两个序列化器虽然都用于 Map 序列化，但有不同的设计目的和实现方式

解决方案

Apache Fury 团队已经修复了这个问题。修复方案主要涉及：

1. 改进对第三方 Map 实现的检测逻辑
2. 为 Fastjson 1.x 的 JSONObject 提供专门的序列化处理
3. 确保在序列化器选择过程中正确处理类型转换

最佳实践

对于使用 Fury 序列化包含 Fastjson 对象的开发者，建议：

1. 如果可能，升级到 Fastjson 2.x 版本，它已经过更好的测试和 Fury 的兼容性验证
2. 如果必须使用 Fastjson 1.x，确保使用最新版本的 Fury，其中已包含对此问题的修复
3. 对于自定义对象中包含第三方集合实现的情况，考虑注册自定义序列化器以确保兼容性

总结

这个问题展示了高性能序列化框架在处理第三方库特定实现时可能遇到的挑战。Fury 通过不断改进其序列化器选择和类型处理逻辑，为开发者提供了更稳定和兼容的序列化体验。开发者在使用时应关注框架版本和依赖库版本的兼容性，以获得最佳的性能和稳定性。