Fastjson2中带Filter和ReferenceDetection特性时的JSON序列化Bug解析

在Fastjson2 2.0.51版本中，开发者发现了一个关于JSON序列化的有趣Bug。当同时使用属性过滤器(PropertyPreFilter)和引用检测特性(ReferenceDetection)时，生成的JSON字符串会出现格式错误，具体表现为自引用属性后面缺少必要的冒号分隔符。

问题现象

当开发者尝试序列化一个包含自引用的Map对象时，如果同时启用了属性过滤器和引用检测特性，生成的JSON字符串会出现语法错误。例如：

Map<String, Object> map = new HashMap<>();
map.put("k", "v");
map.put("selfRef", map);

// 正常输出：{"selfRef":{"$ref":".."},"k":"v"}
String json = JSON.toJSONString(map, Feature.ReferenceDetection);

// 错误输出：{"selfRef"{"$ref":"$"},"k":"v"} ← 注意缺少冒号
String badJson = JSON.toJSONString(map, propertyJsonFilter, Feature.ReferenceDetection);

技术背景

Fastjson2提供了多种序列化特性，其中：

1. PropertyPreFilter：允许开发者在序列化过程中动态决定哪些属性应该被包含在最终的JSON输出中
2. ReferenceDetection：用于处理循环引用问题，当检测到对象引用自身时，会生成特殊的$ref标记而不是无限递归

这两个特性在单独使用时都能正常工作，但当它们组合使用时就会出现格式问题。

问题根源

经过分析，这个Bug出现在序列化器的处理逻辑中。当同时启用过滤器和引用检测时，序列化器在处理自引用属性时，错误地跳过了键值对分隔符(冒号)的输出步骤。这通常发生在：

1. 序列化器首先检查属性是否应该被过滤
2. 然后检测到循环引用，准备输出$ref标记
3. 在这个过程中，格式控制逻辑出现了纰漏，遗漏了必要的冒号

解决方案

Fastjson2团队在2.0.52版本中修复了这个问题。修复方案主要涉及：

1. 确保在输出属性名和属性值之间始终包含分隔符
2. 重构了过滤器和引用检测特性的交互逻辑
3. 增加了针对这种组合场景的测试用例

最佳实践

对于开发者来说，处理循环引用时建议：

1. 明确是否需要引用检测特性 - 只有在确实存在循环引用时才启用
2. 谨慎组合使用多个特性 - 新特性组合应该进行充分测试
3. 及时升级到最新版本 - 以获取Bug修复和新特性

这个Bug的修复体现了Fastjson2团队对细节的关注，也提醒我们在使用复杂特性组合时需要更加谨慎。