Apache Fury Java序列化框架中兼容模式的默认行为解析

Apache Fury作为一款高性能的Java序列化框架，在其0.7.0版本中存在一个关于兼容模式(CompatibleMode)默认行为的文档与实际实现不一致的问题，这个问题涉及到框架的核心序列化机制。

在Fury框架中，CompatibleMode.COMPATIBLE模式的设计初衷是为了提供更好的类型演化支持，允许序列化后的数据结构能够适应类型的变更。根据官方文档描述，当启用兼容模式时，元数据共享(MetaShare)功能默认应该是关闭状态。然而在实际代码实现中，当开发者设置兼容模式但未显式配置元数据共享选项时，框架会自动启用ScopedMetaShare功能。

这个行为差异的核心在于FuryBuilder.java中的逻辑实现。框架内部在检测到兼容模式被激活时，会默认启用ScopedMetaShare来保证类型兼容性，这与文档描述存在出入。ScopedMetaShare作为元数据共享的一种实现方式，能够在特定作用域内共享类型信息，从而提高序列化效率同时保持兼容性。

对于开发者而言，这种文档与实现的不一致可能导致以下影响：

1. 性能预期偏差：元数据共享的开启会影响序列化性能
2. 内存使用变化：共享元数据会带来额外的内存开销
3. 行为不可预期：依赖文档行为的代码可能产生意外结果

目前项目维护者已经确认这是一个文档问题，并计划更新文档以反映实际实现行为。对于使用者来说，如果需要精确控制元数据共享行为，建议在构建Fury实例时显式配置相关选项，而不是依赖默认行为。

这个案例也提醒我们，在使用开源框架时，对于关键配置项的理解不能仅依赖文档，还需要结合源码实现和实际测试来验证行为是否符合预期。