如何正确使用 Jackson 解析嵌套 JSON 到 Java Map 结构

本文详解 jackson 库中处理多层嵌套 json（如 `"resources": {"key": {"value": "test"}}`）时的 java 类型映射技巧，重点解决因泛型擦除和类型不匹配导致的 `mismatchedinputexception` 异常，并提供可直接运行的类型安全方案。

你的 JSON 结构本质上是一个三层嵌套的键值映射：

{
  "resources": {
    "foo": { "value": "test" },
    "bar": { "value": "test" }
  }
}

对应逻辑为：
"resources" → Map，其中每个 value 是一个 Map（例如 "foo" → {"value": "test"}）。
因此，理想的目标类型应为：

Map>

而你原始类中使用的：

private HashMap>> stringListHashMap;

存在两个关键错误：

1. 类型不匹配：JSON 中 "value": "test" 是字符串字面量，但你声明为 List，Jackson 尝试将 "test" 反序列化为 ArrayList，自然抛出 MismatchedInputException；
2. 过度嵌套泛型：HashMap>> 实际表示 {"foo": {"value": ["test"]}}（即 value 是字符串列表），与实际 JSON 不符。

✅ 正确做法是精确匹配 JSON 层级与 Java 类型，并借助 TypeReference 避免泛型擦除问题。

立即学习“Java免费学习笔记（深入）”；

sematic

一个开源的机器学习平台

下载

✅ 推荐解决方案（类型安全、无需 POJO）

直接使用 ObjectMapper.readValue() 配合 TypeReference，声明目标类型为 Map>：

import com.fasterxml.jackson.core.JsonProcessingException;
import com.fasterxml.jackson.databind.ObjectMapper;
import com.fasterxml.jackson.core.type.TypeReference;

import java.util.HashMap;
import java.util.Map;

public class JacksonNestedJsonExample {
    public static void main(String[] args) throws JsonProcessingException {
        ObjectMapper mapper = new ObjectMapper();

        String json = """
            {
              "resources": {
                "foo": { "value": "test" },
                "bar": { "value": "demo" }
              }
            }
            """;

        // 使用 TypeReference 显式指定完整泛型类型
        Map> result = mapper.readValue(json,
            new TypeReference>>() {});

        // 提取 resources 内容
        Map resources = result.get("resources");
        System.out.println(resources.get("foo")); // {value=test}
        System.out.println(resources.get("foo").get("value")); // test
    }
}

? 若需封装为 Java Bean（推荐用于复杂场景）

定义清晰、语义化的 POJO 类，提升可读性与可维护性：

import com.fasterxml.jackson.annotation.JsonProperty;
import java.util.Map;

public class JsonTwoJavaFileModel {
    @JsonProperty("resources")
    private Map resources;

    // 内部类：代表每个资源项（如 "foo"）
    public static class ResourceEntry {
        private String value;

        // getter/setter（Jackson 默认需要）
        public String getValue() { return value; }
        public void setValue(String value) { this.value = value; }
    }

    // getter for resources
    public Map getResources() {
        return resources;
    }
}

使用方式：

JsonTwoJavaFileModel model = mapper.readValue(json, JsonTwoJavaFileModel.class);
String fooValue = model.getResources().get("foo").getValue(); // "test"

⚠️ 注意事项

• ❌ 不要滥用 HashMap 或 List 泛型嵌套来“硬凑”结构——务必与 JSON 字段类型一一对应；
• ✅ 优先使用 Map + TypeReference 快速解析简单嵌套，或用 POJO + 内部类提升工程规范性；
• ? TypeReference 是 Jackson 处理泛型反序列化的标准方式，不可省略（不能写成 mapper.readValue(json, Map.class)，否则会丢失泛型信息）；
• ? 如后续 JSON 中 value 可能是数组（如 "value": ["a","b"]），再改为 Map 并定义 List value ——结构演进应驱动类型演进，而非预设过度复杂泛型。

通过精准建模与 TypeReference 的配合，即可优雅、健壮地解析任意深度的嵌套 JSON，彻底规避 MismatchedInputException。