Jackson ObjectMapper反序列化返回LinkedHashMap而非指定泛型类的解决方法

这个问题本质是Java泛型类型擦除导致的——Jackson在运行时没法识别你期望的params字段是ArrayList<SecondClass>，所以默认把JSON数组转成了LinkedHashMap的列表。下面给你几个实用的解决方案：

1. 反序列化时用TypeReference保留完整泛型信息 #

别直接用ArrayList<FirstClass>.class（泛型信息会被擦除），改用TypeReference来明确告诉Jackson你的泛型结构：

ObjectMapper mapper = new ObjectMapper();
// 通过匿名内部类创建TypeReference，保留ArrayList<FirstClass>的泛型细节
ArrayList<FirstClass> result = mapper.readValue(jsonResponse, new TypeReference<ArrayList<FirstClass>>() {});

这样Jackson就能准确解析FirstClass里的params字段为List<SecondClass>，而不是默认的LinkedHashMap。

2. 确保FirstClass中params字段的泛型定义正确 #

检查你的FirstClass代码，params字段必须明确指定泛型类型，不能用raw type：

public class FirstClass {
    // 正确写法：明确泛型为SecondClass
    private List<SecondClass> params;

    // 对应的getter和setter
    public List<SecondClass> getParams() {
        return params;
    }

    public void setParams(List<SecondClass> params) {
        this.params = params;
    }
}

如果之前是private List params;或者private ArrayList params;这种写法，Jackson根本没法推断具体类型，只能 fallback 到LinkedHashMap。

3. 补救方案：把已得到的LinkedHashMap转成List #

如果已经拿到了包含LinkedHashMap的结果，也可以用Jackson的convertValue方法做转换：

FirstClass firstItem = result.get(0);
// 先把原始params转成LinkedHashMap列表
List<LinkedHashMap<String, Object>> rawParams = (List<LinkedHashMap<String, Object>>) firstItem.getParams();
// 再转换为目标类型List<SecondClass>
ObjectMapper mapper = new ObjectMapper();
List<SecondClass> correctParams = mapper.convertValue(rawParams, new TypeReference<List<SecondClass>>() {});

额外注意事项 #

• 确保SecondClass有无参构造函数，Jackson默认靠这个实例化对象；如果用了全参构造，要给构造方法加@JsonCreator，参数加@JsonProperty("字段名")来映射。
• 如果JSON字段和SecondClass属性名不匹配，记得用@JsonProperty("json_field_name")做字段映射。

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