Fastjson2序列化配置中Integer类型转String失效问题解析

问题背景

在使用Fastjson2进行JSON序列化时，开发者可能会遇到一个特殊需求：将数值类型（如Integer、Long）序列化为字符串形式而非默认的数值形式。这种需求常见于需要与某些特定系统交互的场景，或者为了避免前端JavaScript处理大整数时精度丢失的问题。

问题现象

在Fastjson2 2.0.53版本中，当开发者尝试通过SerializeConfig配置将Integer类型字段序列化为字符串时，发现配置未能生效。具体表现为：

SerializeConfig stringSerializeConfig = new SerializeConfig();
stringSerializeConfig.put(Integer.class, ToStringSerializer.instance);
stringSerializeConfig.put(Long.class, ToStringSerializer.instance);

People one = new People(10, "aaa", 10000000L);
System.out.println(JSON.toJSONString(one, stringSerializeConfig));

预期输出应为：

{"age":"10","hairNums":"10000000","name":"aaa"}

但实际输出却是：

{"age":10,"hairNums":"10000000","name":"aaa"}

可以看到，Long类型的字段被正确序列化为字符串，但Integer类型的字段仍然保持了数值形式。

技术分析

Fastjson2的序列化机制

Fastjson2的序列化过程主要通过SerializeConfig来控制不同类型对象的序列化方式。当配置了特定类型的序列化器后，理论上应该对所有该类型的字段生效。

问题根源

经过分析，这个问题源于Fastjson2内部对基本类型和包装类型的处理逻辑不一致。在2.0.53版本中：

1. 对于Long类型，Fastjson2会检查其包装类型Long.class的序列化配置
2. 但对于Integer类型，Fastjson2内部可能优先处理了基本类型int的序列化逻辑，而忽略了Integer.class的配置

这种不一致性导致了配置在Integer类型上失效，而在Long类型上正常工作。

解决方案

Fastjson2开发团队在2.0.54版本中修复了这个问题。修复方案主要包括：

1. 统一了基本类型和包装类型的处理逻辑
2. 确保当配置了包装类型的序列化器时，对应的基本类型也会应用相同的序列化方式
3. 特别处理了Integer/int类型的序列化配置继承关系

最佳实践

对于需要使用数值转字符串序列化的场景，建议：

1. 升级到Fastjson2 2.0.54或更高版本
2. 同时配置基本类型和包装类型以确保兼容性：

SerializeConfig config = new SerializeConfig();
config.put(Integer.class, ToStringSerializer.instance);
config.put(int.class, ToStringSerializer.instance);
config.put(Long.class, ToStringSerializer.instance);
config.put(long.class, ToStringSerializer.instance);

3. 对于其他数值类型（如Short、Double等），如果需要同样的处理，也应该采用相同的配置方式

总结

Fastjson2作为高性能的JSON处理库，在类型序列化方面提供了灵活的配置方式。开发者在使用时应当注意版本差异，特别是处理基本类型和包装类型的序列化时。2.0.54版本修复的这个bug体现了开源项目持续改进的过程，也提醒我们在使用任何技术组件时都要关注其版本更新和问题修复情况。