Fastjson2反序列化Hutool Tree对象数据丢失问题解析

问题背景

在使用Fastjson2进行JSON反序列化时，开发者发现当Java Bean中包含Hutool工具库的Tree对象时，会出现数据丢失的情况。具体表现为Tree对象中的extra字段在反序列化后消失，而同样的JSON数据使用Jackson库反序列化则能正常保留所有字段。

问题复现

通过一个简单的测试用例可以复现该问题：

public class DemoVO2 implements Serializable {
    private static final long serialVersionUID = 1L;
    List<Tree<String>> treeList;
    // getter和setter方法
}

测试代码显示：

String jsonString = "{\"treeList\":[{\"name\":\"name\",\"id\":\"1\",\"extra\":\"extra\"}]}";

// Fastjson2反序列化
DemoVO2 vo2 = JSON.parseObject(jsonString, DemoVO2.class);
List<Tree<String>> list = vo2.getTreeList();
System.out.println(JSON.toJSONString(list)); // 输出: [{"name":"name","id":"1"}]

// Jackson反序列化
DemoVO2 read = new ObjectMapper().readValue(jsonString, DemoVO2.class);
List<Tree<String>> list1 = read.getTreeList();
System.out.println(JSON.toJSONString(list1)); // 输出: [{"name":"name","id":"1","extra":"extra"}]

问题分析

1. 现象差异：直接使用JSON.parseObject(text)时数据正常，但使用parseObject(text, clazz)时出现数据丢失
2. Dubbo环境：在Dubbo框架中同样存在此问题，Provider到Consumer的传输过程中Tree对象数据丢失
3. 字段丢失：主要影响Tree对象中的extra等扩展字段

技术原理

Fastjson2在反序列化时，对于泛型集合的处理机制与Jackson有所不同。当指定目标类型为具体类时，Fastjson2会尝试使用更严格的反序列化策略，可能导致某些字段被忽略。

Hutool的Tree对象实现了特殊的属性存储机制，extra字段可能被存储在非标准JavaBean属性的结构中，Fastjson2在严格模式下可能无法正确识别这些字段。

解决方案

该问题已在Fastjson2 2.0.49版本中修复。开发者可以：

1. 升级到Fastjson2 2.0.49或更高版本
2. 如果暂时无法升级，可以考虑以下临时解决方案：
   • 使用JSON.parseObject(text)无类型版本
   • 自定义反序列化器处理Tree对象
   • 在Dubbo环境中直接使用List而非包装类

最佳实践

对于包含复杂第三方库对象（如Hutool Tree）的序列化场景，建议：

1. 保持JSON库和依赖库的最新版本
2. 对关键数据结构编写单元测试验证序列化/反序列化行为
3. 考虑使用@JSONField注解明确指定字段映射关系
4. 在分布式系统中，特别注意跨服务传输时的类型一致性

总结

Fastjson2对Hutool Tree对象的反序列化问题展示了JSON库与第三方工具集成时可能遇到的兼容性挑战。通过及时更新库版本和遵循最佳实践，开发者可以避免这类数据丢失问题，确保系统稳定运行。