企业官网建设流程全解析

从fastjson到fastjson2：类型序列化方案深度迁移指南

如果你最近将项目中的fastjson升级到了fastjson2，可能会发现一些原本依赖SerializerFeature.WriteClassName的代码突然失效了。这不是bug，而是fastjson2团队有意为之的设计决策。本文将带你深入理解这一变化背后的原因，并给出完整的迁移方案。

1. 为什么fastjson2移除了WriteClassName？

在fastjson 1.x时代，SerializerFeature.WriteClassName是个常用特性，它能在JSON序列化时写入类名信息。这在处理多态类型或需要精确反序列化的场景特别有用。但这也带来了严重的安全隐患——恶意构造的JSON可以利用类名信息触发任意类加载，成为反序列化攻击的入口。

fastjson2团队在安全审计中发现，大多数开发者使用WriteClassName时并未充分意识到其风险。因此他们决定：

• 完全移除SerializerFeature枚举类，包括WriteClassName
• 默认禁用自动类型识别（autoType）
• 引入更安全可控的替代方案

安全提示：fastjson2强制要求显式声明可反序列化的类型，避免"魔法字符串"带来的安全隐患

2. 新旧方案对比与技术选型

让我们通过表格对比新旧实现方式：

迁移时需要考虑的典型场景：

1. Redis序列化：存储时需要保留类型信息
2. RPC通信：跨服务传输复杂对象结构
3. 本地缓存：可能需要处理继承体系

3. 实战迁移方案

3.1 基础类型处理

对于简单POJO，fastjson2提供了更直观的API：

// 旧写法 String json = JSON.toJSONString(obj, SerializerFeature.WriteClassName); // 新写法 String json = JSON.toJSONString(obj, JSONWriter.Feature.WriteClassName);

反序列化时也必须显式指定类型：

// 必须提供具体类型 MyObject obj = JSON.parseObject(json, MyObject.class); // 或者使用TypeReference处理泛型 List<User> users = JSON.parseObject(json, new TypeReference<List<User>>(){});

3.2 Redis序列化改造

这是最常见的需要迁移的场景。原始文章中的FastJson2JsonRedisSerializer需要调整：

public class FastJson2JsonRedisSerializer<T> implements RedisSerializer<T> { private final Class<T> clazz; private static final Charset DEFAULT_CHARSET = StandardCharsets.UTF_8; public FastJson2JsonRedisSerializer(Class<T> clazz) { this.clazz = clazz; } @Override public byte[] serialize(T t) { if (t == null) return new byte[0]; return JSON.toJSONBytes(t, JSONWriter.Feature.WriteClassName); } @Override public T deserialize(byte[] bytes) { if (bytes == null || bytes.length == 0) return null; return JSON.parseObject(new String(bytes, DEFAULT_CHARSET), clazz); } }

关键修改点：

1. 移除ParserConfig的全局配置
2. 使用JSONWriter.Feature替代SerializerFeature
3. 反序列化时强制要求类型参数

3.3 处理复杂类型体系

对于继承和多态场景，fastjson2要求更明确的类型声明：

@JSONType(typeKey = "@type") public abstract class Animal { private String name; } @JSONType(typeName = "cat") public class Cat extends Animal { private int lives; } @JSONType(typeName = "dog") public class Dog extends Animal { private String breed; } // 序列化时会自动添加类型信息 Animal animal = new Cat(); String json = JSON.toJSONString(animal, JSONWriter.Feature.WriteClassName); // 反序列化需要配置TypeUtils Animal parsed = JSON.parseObject(json, Animal.class);

4. 高级场景与性能优化

4.1 自定义类型命名策略

对于需要精简JSON体积的场景，可以自定义类型标识：

@JSONType(typeName = "c1") // 使用短名称 public class CustomerV1 { //... } // 注册全局别名 JSON.register("c1", CustomerV1.class);

4.2 混合序列化策略

某些场景可能只需要部分字段保留类型信息：

public class Wrapper { @JSONField(serializeFeatures = JSONWriter.Feature.WriteClassName) private Object payload; private String metadata; }

4.3 性能对比数据

我们在相同硬件环境下测试了不同方案的吞吐量（ops/sec）：

迁移到fastjson2不仅能解决兼容性问题，还能获得显著的性能提升。