如何用JSON解析IItem接口对象矩阵？Jackson序列化报错解决

问题原因 #

Jackson处理多维数组时，默认的多态类型注解（比如@JsonTypeInfo）只会作用在顶层对象上，不会自动递归识别数组里的元素类型。序列化IItem[][]时，它错误把数组本身标记成了IItem;类型，而不是识别每个元素实际的子类（Diamond/Grass/Sword），反序列化时自然找不到对应的类型。

修复方法 #

1. 给IItem接口补全正确的多态注解 #

确保注解能被数组里的每个元素继承，明确指定类型ID的存储方式：

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

@JsonTypeInfo(
    use = JsonTypeInfo.Id.NAME,
    include = JsonTypeInfo.As.PROPERTY,
    property = "itemType" // 自定义字段名存储类型标识，保持统一即可
)
@JsonSubTypes({
    @JsonSubTypes.Type(value = Diamond.class, name = "Diamond"),
    @JsonSubTypes.Type(value = Grass.class, name = "Grass"),
    @JsonSubTypes.Type(value = Sword.class, name = "Sword")
})
public interface IItem {
    // 接口方法实现
}

2. 给ObjectMapper开启数组元素的类型解析 #

默认的ObjectMapper不会处理数组元素的多态类型，需手动配置：

import com.fasterxml.jackson.databind.ObjectMapper;
import com.fasterxml.jackson.databind.jsontype.impl.LaissezFaireSubTypeValidator;
import com.fasterxml.jackson.annotation.JsonTypeInfo;

public class Main {
    public static void main(String[] args) {
        ObjectMapper mapper = new ObjectMapper();
        
        // 开启对非final类型的多态解析，覆盖数组元素场景
        mapper.activateDefaultTyping(
            LaissezFaireSubTypeValidator.instance,
            ObjectMapper.DefaultTyping.NON_FINAL,
            JsonTypeInfo.As.PROPERTY
        );
        
        // 测试序列化反序列化流程
        try {
            Player player = new Player();
            // 此处为inventory赋值示例代码
            String jsonStr = mapper.writeValueAsString(player);
            
            Player loadedPlayer = mapper.readValue(jsonStr, Player.class);
        } catch (Exception e) {
            e.printStackTrace();
        }
    }
}

3. 换用List<List>替代二维数组（更省心方案） #

Jackson对集合的多态支持比数组友好得多，把IItem[][] inventory改为List<List<IItem>> inventory，配合上述接口注解，无需额外配置ObjectMapper即可正常工作：

public class Player {
    private List<List<IItem>> inventory;

    // getter、setter方法
}

验证注意点 #

• 序列化后的JSON中，每个道具元素必须包含你指定的类型字段（比如"itemType": "Sword"）
• 反序列化时，Jackson会通过该字段匹配对应子类，不会再出现IItem;无法解析的错误

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