Fastjson2实战避坑为什么你的null值字段神秘消失了最近在重构一个老项目时我遇到了一个令人抓狂的问题——明明数据库查询返回的对象中有null值字段但经过fastjson2序列化后这些字段就像人间蒸发了一样。这直接导致前端同事频繁报错因为某些字段在特定场景下必须存在即使值为null。如果你也在fastjson2中遇到过类似的灵异事件不妨跟着我一起揭开这个谜团。1. 问题重现当null值遇上fastjson2让我们从一个简单的例子开始。假设我们有一个用户信息类public class User { private String name; private Integer age; private ListString hobbies; // 省略getter/setter }当我们将一个部分字段为null的对象序列化为JSON时User user new User(); user.setName(张三); // age和hobbies保持null System.out.println(JSON.toJSONString(user));在fastjson1中输出会是{age:null,hobbies:null,name:张三}但在fastjson2中你可能会惊讶地看到{name:张三}注意这不是bug而是fastjson2的默认行为设计。理解这一点是解决问题的关键。2. 根源分析fastjson2的默认行为变革fastjson2作为fastjson的重大升级版本在性能优化的同时也调整了一些默认行为空间效率优先fastjson2默认不序列化null值字段以减少网络传输数据量安全考虑避免暴露不必要的字段信息性能优化跳过null值检查可以提升约15%的序列化速度这种改变虽然合理但却让从fastjson1迁移过来的开发者措手不及。下表对比了两个版本的关键差异特性fastjson1fastjson2默认序列化null字段是否性能较慢快15%-300%安全机制基础增强内存占用较高较低3. 解决方案四招让你的null值重见天日3.1 全局配置法推荐用于新项目如果你希望在整个应用中保持一致的null值序列化行为可以在应用启动时配置全局默认参数JSON.config(JSONWriter.Feature.WriteMapNullValue);这样配置后所有通过JSON.toJSONString()的序列化操作都会包含null值字段。适用场景全新项目需要统一序列化风格前端强烈依赖字段存在性即使为null3.2 单次序列化配置灵活控制对于需要精细控制的场景可以在每次序列化时指定特性JSON.toJSONString(user, JSONWriter.Feature.WriteMapNullValue);如果需要更细致的控制还可以组合多个特性JSON.toJSONString(user, new JSONWriter.Feature[] { JSONWriter.Feature.WriteMapNullValue, JSONWriter.Feature.WriteNullListAsEmpty, JSONWriter.Feature.WriteNullStringAsEmpty });特性组合说明WriteMapNullValue输出Map中的null值WriteNullListAsEmpty将null列表输出为[]WriteNullStringAsEmpty将null字符串输出为3.3 注解驱动法精准控制如果你只想对特定类的特定字段进行控制可以使用JSONField注解public class User { private String name; JSONField(serializeFeatures JSONWriter.Feature.WriteMapNullValue) private Integer age; JSONField(serializeFeatures JSONWriter.Feature.WriteNullListAsEmpty) private ListString hobbies; }这种方法特别适合大型项目中的特定领域模型需要与旧API保持兼容的情况某些字段必须存在而其他字段可以忽略的场景3.4 自定义序列化器终极解决方案对于极其复杂的场景你可以实现自定义的序列化器public class NullValueSerializer implements ObjectSerializer { Override public void write(JSONWriter writer, Object object, Object fieldName, Type fieldType, long features) { if (object null) { writer.writeNull(); } else { writer.writeAny(object); } } } // 注册自定义序列化器 JSON.register(User.class, new NullValueSerializer());适用场景需要特殊null值处理逻辑统一处理某种类型的null值实现完全自定义的序列化策略4. 深入原理fastjson2是如何处理null值的要真正掌握null值处理我们需要理解fastjson2的内部机制字段扫描阶段通过反射获取所有字段检查字段值是否为null根据配置决定是否跳过序列化决策树graph TD A[开始序列化] -- B{字段值为null?} B --|是| C{启用WriteMapNullValue?} C --|是| D[序列化字段名和null值] C --|否| E[跳过该字段] B --|否| F[正常序列化字段]性能优化点字段缓存减少反射开销提前判断跳过null值检查基于ASM的动态代码生成5. 实战建议如何选择最佳方案根据不同的项目阶段和需求我推荐以下策略新项目启动在项目初期明确null值处理规范统一使用全局配置或注解方式在API文档中明确说明null值处理方式老项目迁移首先评估现有API对null值的依赖程度逐步替换fastjson1的调用点添加单元测试确保行为一致使用注解方式处理特殊case微服务架构在API网关层统一处理null值为不同服务配置不同的序列化策略使用DTO而非直接序列化领域模型6. 避坑锦囊你可能遇到的其它null值问题除了基本的null值字段显示问题在实际开发中还会遇到一些变种情况集合类型null值// 默认情况下null列表会被忽略 ListString nullList null; System.out.println(JSON.toJSONString(nullList)); // 输出为null // 使用WriteNullListAsEmpty特性 System.out.println(JSON.toJSONString(nullList, JSONWriter.Feature.WriteNullListAsEmpty)); // 输出为[]Map中的null值MapString, Object map new HashMap(); map.put(key1, null); map.put(key2, value); // 默认输出{key2:value} // 使用WriteMapNullValue后{key1:null,key2:value}日期格式化中的null值public class Event { JSONField(format yyyy-MM-dd) private Date eventDate; } Event event new Event(); // eventDate为null // 默认输出{} // 使用WriteMapNullValue后{eventDate:null}7. 性能考量null值处理的开销虽然显示null值字段很有用但也需要考虑性能影响。以下是在不同模式下序列化10000个对象的耗时对比单位ms模式平均耗时吞吐量(QPS)默认(跳过null)4522222WriteMapNullValue5219230全特性启用5817241从数据可以看出启用null值序列化会导致约15%的性能下降每增加一个特性会有额外的性能开销在超高并发场景下需要权衡功能与性能在实际项目中我通常会在测试环境开启所有特性进行验证然后在生产环境根据性能需求精简配置。