Fastjson2中WriteNulls特性导致Long/Double字段序列化异常问题分析

问题现象

在Fastjson2 2.0.53版本中，当使用@JSONField(serializeFeatures = {JSONWriter.Feature.WriteNulls})注解时，Long和Double类型的字段在序列化时会出现异常行为：无论字段是否有值，都会被序列化为null。值得注意的是，这个问题仅出现在顶级类中，内部类则不受影响。

问题复现

通过以下代码可以清晰地复现该问题：

// 顶级类
public class Clazz {
    @JSONField(serializeFeatures = {JSONWriter.Feature.WriteNulls})
    private Double d;
    // getter/setter省略
}

// 内部类
static class InnerClazz {
    @JSONField(serializeFeatures = {JSONWriter.Feature.WriteNulls})
    private Double d;
    // getter/setter省略
}

public static void main(String[] args) {
    Clazz c = new Clazz();
    c.setD(1D);
    System.out.println(JSON.toJSONString(c));  // 输出: {"d":null}
    
    InnerClazz ic = new InnerClazz();
    ic.setD(1D);
    System.out.println(JSON.toJSONString(ic)); // 输出: {"d":1.0}
}

问题分析

这个bug揭示了Fastjson2在特定版本中对基本类型包装类(Long/Double)序列化处理的一个缺陷。WriteNulls特性的本意是控制当字段值为null时是否输出null值，但在2.0.53版本中，该特性错误地影响了非null值的序列化行为。

值得注意的是，这个问题表现出以下特点：

1. 仅影响顶级类中的Long/Double字段
2. 内部类不受影响
3. 其他基本类型包装类(Integer/Float等)未报告类似问题

解决方案

Fastjson2团队已经在新版本(2.0.54)中修复了这个问题。开发者可以采取以下措施：

1. 升级到Fastjson2 2.0.54或更高版本
2. 如果暂时无法升级，可以考虑以下临时解决方案：
   • 避免在顶级类中使用WriteNulls特性
   • 将相关字段封装到内部类中
   • 自定义序列化逻辑

技术启示

这个案例提醒我们：

1. 在使用JSON序列化框架时，要特别注意基本类型包装类的处理
2. 新特性的引入可能会带来意想不到的边界条件问题
3. 内部类和顶级类在序列化时可能存在不同的处理逻辑
4. 及时关注框架的更新和bug修复

Fastjson2作为高性能的JSON处理库，其开发团队对问题的响应速度值得肯定。开发者在使用时应当注意版本兼容性，并及时跟进官方更新。