使用Jackson反序列化带类型标识的JSON数组时类型解析失败求助

问题根源 #

当你使用@JsonFormat(shape = JsonFormat.Shape.ARRAY)将Wrapper序列化为数组结构时，Jackson的EXTERNAL_PROPERTY类型解析机制无法正常工作。这是因为EXTERNAL_PROPERTY依赖对象结构中键值对的关联关系——外部属性（如type）和目标属性（如animal）需要是同一对象下的兄弟字段。但数组是按顺序存储的元素，Jackson在解析数组中的animal元素时，无法正确关联到同属数组的type字段值，导致子类型解析失败，进而触发整个Wrapper的反序列化异常。

解决方案 #

方案一：自定义构造器手动处理类型解析（保留原JSON结构）

通过给Wrapper添加@JsonCreator注解的构造器，按数组元素顺序接收参数，手动根据type字段实例化对应的Animal子类，避开数组结构下EXTERNAL_PROPERTY的限制：

import com.fasterxml.jackson.annotation.JsonFormat;
import com.fasterxml.jackson.annotation.JsonPropertyOrder;
import com.fasterxml.jackson.databind.JsonNode;
import com.fasterxml.jackson.databind.ObjectMapper;

class Scratch {

    private static ObjectMapper objectMapper = new ObjectMapper();

    @JsonFormat(shape = JsonFormat.Shape.ARRAY)
    @JsonPropertyOrder({"type", "uniqueId", "animal"})
    public static class Wrapper {

        public String type;
        public String uniqueId;
        public Animal animal;

        // 默认构造器，用于序列化
        public Wrapper() {}

        // 自定义反序列化构造器
        @JsonCreator
        public Wrapper(String type, String uniqueId, JsonNode animalNode) throws Exception {
            this.type = type;
            this.uniqueId = uniqueId;
            // 根据type匹配对应的Animal子类
            switch (type) {
                case "cat":
                    this.animal = objectMapper.treeToValue(animalNode, Cat.class);
                    break;
                // 后续扩展其他Animal子类时添加对应case
                default:
                    throw new IllegalArgumentException("Unknown animal type: " + type);
            }
        }
    }

    public interface Animal {
        int getLegs();
    }

    public static class Cat implements Animal {
        public int legs = 4;
        @Override
        public int getLegs() {
            return legs;
        }
    }

    public static void main(String[] args) throws Exception {
        Wrapper wrapper = new Wrapper();
        wrapper.type = "cat";
        wrapper.uniqueId = "123";
        wrapper.animal = new Cat();

        String json = objectMapper.writeValueAsString(wrapper);
        System.out.println(json); // 输出：["cat","123",{"legs":4}]

        Wrapper deserialized = objectMapper.readValue(json, Wrapper.class);
        System.out.println(deserialized.animal.getLegs()); // 输出：4
    }
}

方案二：调整类型解析注解（需修改JSON结构）

如果允许修改序列化后的JSON结构，可以将类型信息嵌入Animal自身的JSON对象中，改用As.PROPERTY类型解析方式：

@JsonFormat(shape = JsonFormat.Shape.ARRAY)
@JsonPropertyOrder({"type", "uniqueId", "animal"})
public static class Wrapper {
    public String type;
    public String uniqueId;

    @JsonTypeInfo(
            use = JsonTypeInfo.Id.NAME,
            include = JsonTypeInfo.As.PROPERTY,
            property = "type"
    )
    @JsonSubTypes({
            @JsonSubTypes.Type(value = Cat.class, name = "cat")
    })
    public Animal animal;
}

此方案下，序列化后的JSON会变为["cat","123",{"type":"cat","legs":4}]，反序列化可正常完成，但会改变原有的JSON结构。

验证结果 #

使用方案一修改后，序列化输出保持原格式["cat","123",{"legs":4}]，反序列化可成功解析Animal子类型，正常输出结果。

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