Fastjson 中不存在 BeanContext 类，正确替代是 JSONWriter.Context 和 JSONReader.Context；二者支持链式注册序列化/反序列化处理器，实现类型安全、动态可控的编解码，且需每次新建或 ThreadLocal 复用。
Fastjson 中并没有 BeanContext 这个公开 API 类。这是常见误解——它实际并不存在于 Fastjson 1.x 或 2.x 的官方类库中（com.alibaba.fastjson 或 com.alibaba.fastjson2 包下均无 BeanContext）。你可能混淆了以下几种概念：
-
Jackson 的
BeanDescription/SerializationConfig/DeserializationContext -
Spring 的
BeanFactory或ApplicationContext -
Fastjson 2.x 中真正起作用的上下文类：
JSONWriter.Context和JSONReader.Context - 或是误记了早期社区自定义封装工具类的命名
✅ 正确路径是：用 JSONWriter.Context 和 JSONReader.Context 实现动态、类型安全、可复用的解析控制，这才是 Fastjson 2.x 推荐的“上下文级”优化方式。
✅ 使用 JSONWriter.Context 控制序列化行为
适用于统一日期格式、枚举序列化策略、空值处理等需按类型定制的场景：
JSONWriter.Context ctx = new JSONWriter.Context()
.registerSerializer(LocalDateTime.class, (obj, writer) ->
writer.writeAsString(((LocalDateTime) obj).format(DateTimeFormatter.ofPattern("yyyy-MM-dd HH:mm:ss"))))
.registerSerializer(StatusEnum.class, (obj, writer) ->
writer.writeString(((StatusEnum) obj).getCode()));
String json = JSON.toJSONString(data, ctx);- 支持链式注册多个类型处理器
- 避免全局配置污染，线程安全（每个 Context 实例独立）
- 比反射+注解更高效，尤其在高频调用时
✅ 使用 JSONReader.Context 实现反序列化动态适配
解决泛型擦除、字段别名映射、条件反序列化等需求：
立即学习“Java免费学习笔记（深入）”；
JSONReader.Context ctx = new JSONReader.Context()
.registerDeserializer(User.class, (reader, type) -> {
reader.startObject();
User user = new User();
while (reader.hasNext()) {
String field = reader.readFieldName();
switch (field) {
case "user_name": user.setName(reader.readString()); break;
case "age_val": user.setAge(reader.readInt32()); break;
default: reader.skipValue(); break;
}
}
reader.endObject();
return user;
});
User user = JSON.parseObject(json, User.class, ctx);- 可绕过默认反射逻辑，手动控制字段读取流程
- 适合兼容旧版字段名、协议迁移、敏感字段跳过等场景
- 不依赖
@JSONField(name="xxx")，运行时决定映射逻辑
✅ 结合 TypeReference + Context 实现泛型精准还原
避免 ClassCastException 的关键组合：
// ❌ 错误：泛型信息丢失
List<User> list1 = JSON.parseObject(json, List.class); // 元素是 LinkedHashMap！
// ✅ 正确：TypeReference + Context（可选）
List<User> list2 = JSON.parseObject(json,
new TypeReference<List<User>>() {},
new JSONReader.Context().registerDeserializer(User.class, customUserDeserializer)
);-
TypeReference保留泛型类型擦除前的结构 -
JSONReader.Context在该泛型内进一步定制子类型行为 - 二者配合，才能真正实现「动态 + 类型安全」解析
⚠️ 注意事项
-
JSONWriter.Context和JSONReader.Context不可跨线程共享，每次使用建议新建或通过 ThreadLocal 复用 - 不要尝试在
SerializeConfig或ParserConfig（Fastjson 1.x 类）中寻找BeanContext，它们在 2.x 中已被移除或废弃 - 若项目仍用 Fastjson 1.x，请改用
ParserConfig.getGlobalInstance().setAutoTypeSupport(true)等替代方案，但强烈建议升级到 2.x 并转向 Context 模式
不复杂但容易忽略。
