在Jackson反序列化过程中，当接口或父类期望接收数据，而实际JSON包含具体子类的特有字段时，若未显式声明类型关系，就会出现子类字段被忽略或反序列化失败的情况。不修改原有实体类、不使用任何Jackson注解，依然可以通过编程方式解决该问题。
问题背景
假设我们有一个父类 Animal 和两个子类 Dog、Cat，子类分别拥有 barkSound 与 meowSound 字段。当接口返回的是子类对象，但反序列化目标声明为 Animal 时，Jackson默认只能填充父类已有字段。
无注解解决思路
核心方案是注册一个自定义的 JsonDeserializer，在反序列化时读取原始JSON节点，依据存在的字段特征判断具体子类类型，再委托给对应子类完成解析。
定义模型类
// 父类不添加任何Jackson注解
class Animal {
public String name;
}
// 子类Dog，无注解
class Dog extends Animal {
public String barkSound;
}
// 子类Cat，无注解
class Cat extends Animal {
public String meowSound;
}
自定义反序列化器
通过判断JSON中是否包含 barkSound 或 meowSound 字段，决定实例化哪一个子类。
import com.fasterxml.jackson.core.JsonParser;
import com.fasterxml.jackson.databind.DeserializationContext;
import com.fasterxml.jackson.databind.JsonNode;
import com.fasterxml.jackson.databind.ObjectMapper;
import com.fasterxml.jackson.databind.deser.std.StdDeserializer;
import java.io.IOException;
public class AnimalDeserializer extends StdDeserializer<Animal> {
public AnimalDeserializer() {
super(Animal.class);
}
@Override
public Animal deserialize(JsonParser p, DeserializationContext ctxt) throws IOException {
ObjectMapper mapper = (ObjectMapper) p.getCodec();
JsonNode node = mapper.readTree(p);
// 根据字段特征识别子类
if (node.has("barkSound")) {
return mapper.treeToValue(node, Dog.class);
} else if (node.has("meowSound")) {
return mapper.treeToValue(node, Cat.class);
}
return mapper.treeToValue(node, Animal.class);
}
}
配置ObjectMapper
将自定义反序列化器绑定到 Animal 类型，无需在类上写任何注解。
import com.fasterxml.jackson.databind.module.SimpleModule;
import com.fasterxml.jackson.databind.ObjectMapper;
ObjectMapper objectMapper = new ObjectMapper();
SimpleModule module = new SimpleModule();
module.addDeserializer(Animal.class, new AnimalDeserializer());
objectMapper.registerModule(module);
// 测试反序列化
String jsonDog = "{"name":"阿黄","barkSound":"汪汪"}";
Animal animal = objectMapper.readValue(jsonDog, Animal.class);
System.out.println(animal.getClass().getSimpleName());
方案优缺点
- 优点：实体类保持干净，适合第三方库或不可修改源码的场景。
- 优点：识别逻辑灵活，可基于任意字段组合判断。
- 缺点：需要手动维护类型判断规则，子类增多时逻辑会变复杂。
总结
通过自定义 StdDeserializer 并在 ObjectMapper 中注册，可以在完全不使用注解的前提下解决Jackson子类字段识别异常。该方式将类型路由控制权交还给代码，在约束较多的项目中具备实用价值。