Jackson反序列化接口实现类对象映射失败问题求助

各位大佬好！我最近在做Jackson反序列化的时候碰到了一个棘手的问题，想请大家帮忙分析下。

情况是这样的：我们项目里有个Source接口，有SimpleSource和ComplexSource两个实现类。这些类的实例会被放到SourceContainer对象的列表属性里，现在我要把存储SourceContainer配置的JSON反序列化成Java对象，结果直接报错了，错误信息如下：

com.fasterxml.jackson.databind.exc.InvalidTypeIdException: Could not resolve subtype of [simple type, class org.example.SimpleSource]: missing type id property 'jacksonType' (for POJO property 'simpleSources')
 at [Source: REDACTED (`StreamReadFeature.INCLUDE_SOURCE_IN_LOCATION` disabled); line: 5, column: 5] (through reference chain: org.example.SourceContainer["simpleSources"]->java.util.ArrayList[0])

为了方便大家复现问题，我把相关类的精简代码贴出来：

package org.example;

import com.fasterxml.jackson.databind.DeserializationFeature;
import com.fasterxml.jackson.databind.ObjectMapper;
import java.util.List;

// Source接口
public interface Source {
    // 接口定义的方法
}

// SimpleSource实现类
public class SimpleSource implements Source {
    // 类属性和方法
}

// ComplexSource实现类
public class ComplexSource implements Source {
    // 类属性和方法
}

// SourceContainer类
public class SourceContainer {
    private List<SimpleSource> simpleSources;
    private List<ComplexSource> complexSources;

    // getter和setter方法
}

后来我仔细分析错误信息，发现核心问题是：Jackson反序列化接口类型的对象时，需要明确的类型标识来区分不同的实现类，而当前的JSON和代码里都没有提供这个标识，所以才会报错。

下面是我亲测有效的几个解决方案，大家可以根据自己的场景选择：

方案一：给接口添加Jackson类型注解（最常用） #

我们可以通过注解告诉Jackson如何识别不同的实现类，具体操作如下：

首先在Source接口上添加类型注解：

package org.example;

import com.fasterxml.jackson.annotation.JsonSubTypes;
import com.fasterxml.jackson.annotation.JsonTypeInfo;

@JsonTypeInfo(
    use = JsonTypeInfo.Id.NAME,
    include = JsonTypeInfo.As.PROPERTY,
    property = "jacksonType" // 这里要和报错里的类型属性名保持一致
)
@JsonSubTypes({
    @JsonSubTypes.Type(value = SimpleSource.class, name = "simple"),
    @JsonSubTypes.Type(value = ComplexSource.class, name = "complex")
})
public interface Source {
    // 接口方法
}

同时，JSON数据里每个Source对象都需要包含jacksonType字段，示例如下：

{
  "simpleSources": [
    {
      "jacksonType": "simple",
      "name": "测试简单源"
    }
  ],
  "complexSources": [
    {
      "jacksonType": "complex",
      "name": "测试复杂源",
      "config": {}
    }
  ]
}

这样Jackson就能通过jacksonType字段准确判断每个对象对应的实现类，顺利完成反序列化。

方案二：配置ObjectMapper指定默认类型（适用于单实现类场景） #

如果你的接口只有一个实现类，或者想固定默认实现类，可以在ObjectMapper里配置：

ObjectMapper objectMapper = new ObjectMapper();
// 为Source接口指定默认实现类
objectMapper.addMixIn(Source.class, DefaultSourceMixIn.class);

// 定义MixIn类来配置类型信息
abstract class DefaultSourceMixIn {
    @JsonTypeInfo(use = JsonTypeInfo.Id.CLASS, include = JsonTypeInfo.As.PROPERTY)
}

方案三：自定义反序列化器（灵活度最高） #

如果上面的方案都不符合需求，还可以自定义反序列化器，手动根据JSON字段判断实现类：

public class SourceDeserializer extends StdDeserializer<Source> {

    protected SourceDeserializer() {
        super(Source.class);
    }

    @Override
    public Source deserialize(JsonParser p, DeserializationContext ctxt) throws IOException {
        JsonNode node = p.getCodec().readTree(p);
        // 根据JSON里的独有字段判断实现类
        if (node.has("simpleExclusiveField")) {
            return p.getCodec().treeToValue(node, SimpleSource.class);
        } else if (node.has("complexExclusiveField")) {
            return p.getCodec().treeToValue(node, ComplexSource.class);
        }
        throw new IllegalArgumentException("无法识别的Source类型");
    }
}

然后在Source接口上指定这个反序列化器：

@JsonDeserialize(using = SourceDeserializer.class)
public interface Source {
    // 接口方法
}

我自己最后用方案一解决了问题，亲测好用，大家可以试试~

备注：内容来源于stack exchange，提问作者Vsevolod Rostovskiy