Jackson 在反序列化深度递归泛型结构（如 Menu → Item<Menu> → Item<Item<Menu>>…）时会因类型推导无限递归导致 StackOverflowError，需通过自定义反序列化器或类型引用规避。

jackson 在反序列化深度递归泛型结构（如 `menu → item

→ item>…`）时会因类型推导无限递归导致 stackoverflowerror，需通过自定义反序列化器或类型引用规避。

Jackson 的 ObjectMapper 默认通过反射和类型元数据（如 TypeReference 和泛型签名）构建反序列化器链。当遇到形如 Item<P extends ItemContainer<P>> 这类自引用泛型（即 Item<Item<Item<...>>>）时，Jackson 在解析 SimpleType 的规范名称（toCanonical()）过程中反复展开类型参数，最终触发无限递归，抛出 StackOverflowError —— 这并非 Bug，而是其类型系统对开放递归泛型缺乏内置终止机制所致。

根本解决方案不是禁用泛型，而是切断类型推导循环。推荐两种生产级实践：

✅ 方案一：注册自定义反序列化器（推荐）

为顶层入口类（如 NavMenu）编写轻量级 StdDeserializer，显式控制子对象的反序列化流程，避免泛型类型自动推导：

public class NavMenuDeserializer extends StdDeserializer<NavMenu> {
    protected NavMenuDeserializer() {
        super(NavMenu.class);
    }

    @Override
    public NavMenu deserialize(JsonNode node, DeserializationContext ctx) throws IOException {
        NavMenu menu = new NavMenu();
        JsonNode menusNode = node.get("menus");
        if (menusNode != null && menusNode.isArray()) {
            for (JsonNode menuNode : menusNode) {
                // 关键：使用 context.readValue(..., Menu.class) 显式指定目标类型
                // 绕过泛型类型自动推导，防止递归展开
                Menu m = ctx.readValue(menuNode.traverse(), Menu.class);
                menu.add(m); // 假设 NavMenu 提供 add(Menu) 方法
            }
        }
        return menu;
    }
}

注册方式：

ObjectMapper mapper = new ObjectMapper();
SimpleModule module = new SimpleModule();
module.addDeserializer(NavMenu.class, new NavMenuDeserializer());
mapper.registerModule(module);

⚠️ 注意事项：

• context.readValue(node.traverse(), Type) 是关键，它跳过 Jackson 对当前节点泛型上下文的自动推导；
• 确保 NavMenu、Menu 等类有无参构造器（或使用 @JsonCreator）；
• 若 Menu 类本身也含递归字段（如 items），建议对其同样注册专用反序列化器，或改用 @JsonDeserialize 注解直接绑定。

✅ 方案二：改用 TypeReference + 手动构建（适用于简单场景）

若结构层级可控，可放弃泛型自动映射，改用 TypeReference 显式声明“非递归”的扁平类型：

// 定义固定深度的类型引用（避免无限展开）
TypeReference<List<Menu>> menuType = new TypeReference<>() {};
List<Menu> menus = mapper.readValue(jsonString, menuType);

但此法不适用于真正动态嵌套的树形结构（如菜单深度未知），仅作补充参考。

? 不推荐的规避方式

• @JsonIgnore 移除递归字段：破坏数据完整性；
• @JsonUnwrapped 或 @JsonAlias：无法解决类型推导本质问题；
• 升级 Jackson 版本：该问题在 2.15+ 仍存在，属设计限制而非缺陷。

总结：面对泛型递归结构，Jackson 要求开发者主动介入类型解析流程。自定义 StdDeserializer 是最清晰、可维护且符合 Jackson 设计哲学的方案——它将反序列化逻辑从“框架自动推导”转为“开发者显式控制”，既规避栈溢出，又保持类型安全与业务语义完整。