Java中使用Jackson配置嵌套属性为多态鉴别器的JSON映射问题

问题核心原因 #

Jackson原生的@JsonTypeInfo的property属性仅支持识别待反序列化对象的顶层属性，不支持直接读取嵌套层级的属性作为鉴别器，所以你原来的配置无法生效。

方案1：自定义TypeIdResolver（推荐，不改变原有数据结构） #

实现步骤 #

1. 先修复代码中基础拼写错误
   • 抽象类名Mamals修正为Mammals，保持继承关系一致
   • Cat类中private in age修正为private int age
2. 编写自定义类型鉴别器解析器，从嵌套的data_info.ns读取类型标识

import com.fasterxml.jackson.databind.DatabindContext;
import com.fasterxml.jackson.databind.JavaType;
import com.fasterxml.jackson.databind.jsontype.impl.TypeIdResolverBase;
import java.io.IOException;

public class NestedNsTypeIdResolver extends TypeIdResolverBase {
    private JavaType superType;

    @Override
    public void init(JavaType javaType) {
        this.superType = javaType;
    }

    @Override
    public String idFromValue(Object o) {
        if (o instanceof DataTypeInfo dataTypeInfo) {
            TypeInfo typeInfo = dataTypeInfo.getTypeInfo();
            return typeInfo != null ? typeInfo.getNameSpace() : null;
        }
        return null;
    }

    @Override
    public String idFromValueAndType(Object o, Class<?> aClass) {
        return idFromValue(o);
    }

    @Override
    public JavaType typeFromId(DatabindContext databindContext, String s) throws IOException {
        if ("cat".equals(s)) {
            return databindContext.constructType(Cat.class);
        } else if ("dog".equals(s)) {
            return databindContext.constructType(Dog.class);
        }
        throw new IllegalArgumentException("未知的类型ns: " + s);
    }

    @Override
    public JsonTypeInfo.Id getMechanism() {
        return JsonTypeInfo.Id.CUSTOM;
    }
}

3. 修改Mammals抽象类的注解配置，删除原有@JsonSubTypes注解

import com.fasterxml.jackson.annotation.JsonTypeInfo;
import com.fasterxml.jackson.databind.annotation.JsonTypeIdResolver;

@JsonTypeInfo(
    use = JsonTypeInfo.Id.CUSTOM, 
    include = JsonTypeInfo.As.EXISTING_PROPERTY, 
    property = "data_info", 
    visible = true
)
@JsonTypeIdResolver(NestedNsTypeIdResolver.class)
public abstract class Mammals extends DataTypeInfo {    
}

4. 可选配置：如果你的JSON中布尔值为大写True/False，需要额外配置ObjectMapper兼容

ObjectMapper mapper = new ObjectMapper();
mapper.configure(JsonParser.Feature.ALLOW_UPPER_CASE_BOOLEANS, true);

方案2：使用@JsonUnwrapped展开嵌套字段（代码更简洁） #

实现步骤 #

1. 同样先修复上文中提到的基础拼写错误
2. 在DataTypeInfo类的typeInfo字段上添加@JsonUnwrapped注解，将嵌套字段展开到对象顶层

import com.fasterxml.jackson.annotation.JsonUnwrapped;

public class DataTypeInfo {
    @JsonUnwrapped(prefix = "data_info.")
    TypeInfo typeInfo;
}

3. 保留你原有Mammals类上的@JsonTypeInfo和@JsonSubTypes配置即可直接生效

方案优缺点说明 #

• 方案1：完全保留原有JSON嵌套结构，序列化和反序列化都符合原始格式，适合绝大多数生产场景
• 方案2：无需编写自定义解析逻辑，代码改动量小，但序列化时会把data_info.ns展开为顶层字段，如果你需要序列化输出和原始JSON结构一致则不适用

内容的提问来源于stack exchange，提问作者Valerian