Fastjson2中WriteNonStringValueAsString特性对Boolean类型的处理问题解析

在Fastjson2 2.0.49版本中，开发者发现了一个关于WriteNonStringValueAsString特性的实现缺陷。这个特性本应将所有非字符串类型的值序列化为字符串形式，但在处理Boolean类型时却未能按预期工作。

问题背景

WriteNonStringValueAsString是Fastjson2提供的一个序列化特性，它的设计目的是将数值、布尔等非字符串类型的值转换为字符串形式输出。这在某些需要严格类型一致性的场景下非常有用，比如与某些前端框架交互或日志记录等场景。

问题表现

测试案例清晰地展示了这个问题：

1. 对于基本类型boolean和包装类型Boolean的true值，预期输出应为"true"字符串形式
2. 但实际输出中，基本类型boolean被正确转换为字符串，而包装类型Boolean却保持了原始布尔形式

技术分析

这个问题源于Fastjson2在实现WriteNonStringValueAsString特性时，对Boolean类型的处理不够全面。具体来说：

1. 对于基本类型boolean，Fastjson2能够正确识别并转换为字符串
2. 但对于包装类型Boolean，序列化时没有应用相同的转换逻辑
3. 这种不一致性会导致API行为不符合预期，可能引发下游系统解析错误

解决方案

Fastjson2开发团队在2.0.50版本中修复了这个问题，主要改进包括：

1. 统一处理基本类型和包装类型的布尔值
2. 确保Boolean类型也能正确应用WriteNonStringValueAsString特性
3. 保持与其他数值类型(如Integer)处理方式的一致性

升级建议

对于使用Fastjson2并依赖WriteNonStringValueAsString特性的项目，建议：

1. 检查项目中是否有依赖Boolean类型被序列化为字符串的场景
2. 如果有，应尽快升级到2.0.50或更高版本
3. 升级后进行全面测试，确保序列化结果符合预期

这个问题的修复体现了Fastjson2团队对细节的关注和对API一致性的重视，也提醒开发者在处理类型系统时要特别注意基本类型和包装类型的区别。