本文详解 jackson 库中处理多层嵌套 json（如 `"resources": {"key": {"value": "test"}}`）时的 java 类型映射技巧，重点解决因泛型擦除和类型不匹配导致的 `mismatchedinputexception` 异常，并提供可直接运行的类型安全方案。
你的 JSON 结构本质上是一个三层嵌套的键值映射：
{
"resources": {
"foo": { "value": "test" },
"bar": { "value": "test" }
}
}对应逻辑为：
"resources" → Map<String, ?>，其中每个 value 是一个 Map<String, String>（例如 "foo" → {"value": "test"}）。
因此，理想的目标类型应为：
Map<String, Map<String, String>>
而你原始类中使用的：
private HashMap<String, HashMap<String, List<String>>> stringListHashMap;
存在两个关键错误：
- 类型不匹配：JSON 中 "value": "test" 是字符串字面量，但你声明为 List<String>，Jackson 尝试将 "test" 反序列化为 ArrayList，自然抛出 MismatchedInputException；
- 过度嵌套泛型：HashMap<String, HashMap<String, List<String>>> 实际表示 {"foo": {"value": ["test"]}}（即 value 是字符串列表），与实际 JSON 不符。
✅ 正确做法是精确匹配 JSON 层级与 Java 类型，并借助 TypeReference 避免泛型擦除问题。
立即学习“Java免费学习笔记（深入）”；
✅ 推荐解决方案（类型安全、无需 POJO）
直接使用 ObjectMapper.readValue() 配合 TypeReference，声明目标类型为 Map<String, Map<String, String>>：
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<String, Map<String, String>> result = mapper.readValue(json,
new TypeReference<Map<String, Map<String, String>>>() {});
// 提取 resources 内容
Map<String, String> 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<String, ResourceEntry> 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<String, ResourceEntry> getResources() {
return resources;
}
}使用方式：
JsonTwoJavaFileModel model = mapper.readValue(json, JsonTwoJavaFileModel.class);
String fooValue = model.getResources().get("foo").getValue(); // "test"⚠️ 注意事项
- ❌ 不要滥用 HashMap 或 List 泛型嵌套来“硬凑”结构——务必与 JSON 字段类型一一对应；
- ✅ 优先使用 Map<String, ?> + TypeReference 快速解析简单嵌套，或用 POJO + 内部类提升工程规范性；
- ? TypeReference 是 Jackson 处理泛型反序列化的标准方式，不可省略（不能写成 mapper.readValue(json, Map.class)，否则会丢失泛型信息）；
- ? 如后续 JSON 中 value 可能是数组（如 "value": ["a","b"]），再改为 Map<String, ResourceWithList> 并定义 List<String> value ——结构演进应驱动类型演进，而非预设过度复杂泛型。
通过精准建模与 TypeReference 的配合，即可优雅、健壮地解析任意深度的嵌套 JSON，彻底规避 MismatchedInputException。
