本文详解如何使用 Jackson 实现两级条件驱动的 JSON 反序列化：先通过 job/notify 字段存在性判断抽象子类，再依据 object.type 值精确映射到四个具体实现类，规避 @JsonTypeInfo 覆盖限制与递归反序列化陷阱。
本文详解如何使用 jackson 实现两级条件驱动的 json 反序列化：先通过 `job`/`notify` 字段存在性判断抽象子类，再依据 `object.type` 值精确映射到四个具体实现类，规避 `@jsontypeinfo` 覆盖限制与递归反序列化陷阱。
在复杂领域模型中，JSON 数据常需根据动态字段组合决定目标 Java 类型——例如本例中的四类回调（DomainJobCallback、TransferJobCallback、DomainNotificationCallback、TransferNotificationCallback），其继承结构为三层抽象体系：根抽象类 Callback → 两个中间抽象类 JobCallback 和 NotificationCallback → 四个最终具体类。Jackson 默认的 @JsonTypeInfo 机制无法嵌套配置（如在 Callback 上设 DEDUCTION，又在子类上设 NAME），而直接复用 ObjectMapper.treeToValue() 易引发 InvalidTypeIdException 或 StackOverflowError。根本原因在于：自定义反序列化器中新建 ObjectMapper 实例并调用 treeToValue() 时，若未禁用默认的 getter/setter 反射策略，且未显式启用字段可见性，Jackson 会尝试访问不存在的 getter 方法，或陷入自身反序列化器的无限递归调用。
✅ 正确解法是：统一配置 ObjectMapper 的可见性策略 + 使用 SimpleModule 注册自定义反序列化器，而非依赖类级注解。关键配置如下：
ObjectMapper objectMapper = new ObjectMapper(); SimpleModule module = new SimpleModule(); module.addDeserializer(Callback.class, new CallbackDeserializer()); objectMapper.registerModule(module); // 关键：关闭所有属性访问器默认行为，仅启用字段直读 objectMapper.setVisibility(PropertyAccessor.ALL, JsonAutoDetect.Visibility.NONE); objectMapper.setVisibility(PropertyAccessor.FIELD, JsonAutoDetect.Visibility.ANY);
该配置确保 Jackson 直接读写 Java 字段（job、notify、object.type），绕过缺失 getter 的异常，并阻止反序列化器被重复触发。此时 CallbackDeserializer 可安全使用 mapper.treeToValue(node, TargetClass.class)，因为目标类字段已对 Jackson 完全可见。
以下是完整、健壮的 CallbackDeserializer 实现（含空值防护与类型校验）：
public static class CallbackDeserializer extends JsonDeserializer<callback> {
private final ObjectMapper mapper = new ObjectMapper();
@Override
public Callback deserialize(JsonParser p, DeserializationContext ctxt)
throws IOException {
JsonNode node = p.getCodec().readTree(p);
JsonNode jobNode = node.get("job");
JsonNode notifyNode = node.get("notify");
if (jobNode != null && !jobNode.isNull()) {
return parseJobCallback(node);
} else if (notifyNode != null && !notifyNode.isNull()) {
return parseNotificationCallback(node);
} else {
throw ctxt.mappingException("Missing required field: 'job' or 'notify'");
}
}
private Callback parseJobCallback(JsonNode node) throws IOException {
String type = extractObjectType(node);
return switch (type) {
case "Domain" -> mapper.treeToValue(node, DomainJobCallback.class);
case "Transfer" -> mapper.treeToValue(node, TransferJobCallback.class);
default -> throw new IllegalArgumentException("Unsupported job type: " + type);
};
}
private Callback parseNotificationCallback(JsonNode node) throws IOException {
String type = extractObjectType(node);
return switch (type) {
case "Domain" -> mapper.treeToValue(node, DomainNotificationCallback.class);
case "Transfer" -> mapper.treeToValue(node, TransferNotificationCallback.class);
default -> throw new IllegalArgumentException("Unsupported notification type: " + type);
};
}
private String extractObjectType(JsonNode node) {
JsonNode objectNode = node.get("object");
if (objectNode == null || !objectNode.isObject()) {
throw new IllegalArgumentException("'object' field is missing or not an object");
}
JsonNode typeNode = objectNode.get("type");
if (typeNode == null || !typeNode.isTextual()) {
throw new IllegalArgumentException("'object.type' field is missing or not a string");
}
return typeNode.asText();
}
}</callback>
? 重要注意事项：
- ✅ 禁止在反序列化器中新建 ObjectMapper 实例用于同类型解析：虽然本方案允许（因已配置字段可见性），但更推荐复用外部 ObjectMapper 实例（通过构造函数注入），避免资源浪费；
- ✅ 务必添加字段存在性与类型校验：extractObjectType() 中对 object 和 object.type 的双重检查可提前捕获无效 JSON，提升错误可读性；
- ❌ 不要在类上保留冲突的 @JsonTypeInfo 注解：如示例中被注释掉的 @JsonTypeInfo(use = NAME, property = "object.type")，它们会与自定义逻辑冲突；
- ✅ 配合 @JsonIgnoreProperties(ignoreUnknown = true) 使用：容忍未来扩展字段，增强 API 兼容性。
最终，该方案以最小侵入性达成精准类型路由：既不手动逐字段赋值（保持开发效率），也不依赖 Jackson 的自动类型推断缺陷（保障稳定性），是处理多条件 JSON 多态反序列化的工业级实践范式。
