标题：使用递归CTE与手动图构建实现JPA中N层自引用树结构的完整加载_技术教程

本文介绍如何在不触发“cannot simultaneously fetch multiple bags”错误的前提下，通过postgresql递归cte配合hibernate 6.2+或blaze-persistence，高效加载具有任意深度父子关系（自引用）且末级关联独立集合（如xmlperiod）的完整对象树。

在JPA/Hibernate中处理深度未知的自引用树结构（如XmlObject父子嵌套）并同时拉取末级叶子节点的关联集合（如xmlPeriods），是典型的高阶ORM难题。直接使用多层JOIN FETCH会导致笛卡尔积爆炸、重复结果及MultipleBagFetchException；而分步N+1查询或@Fetch(

FetchMode.SUBSELECT)又无法保证层级完整性与事务一致性。

根本限制在于：JPA规范不支持递归fetch join，Hibernate 6.2之前也无原生递归CTE语法支持。

✅ 正确解法分两步：数据层递归查询 + 应用层图重建。

1. 使用递归CTE一次性获取全树节点（含父子关系）

借助Hibernate 6.2+对WITH RECURSIVE的原生支持，编写HQL递归查询（推荐）或原生SQL（需映射）。以下为标准HQL写法（需启用hibernate.hql.bulk_id_strategy=inline）：

@Query("""
    WITH RECURSIVE nodes AS (
        -- 锚点：根节点（可传入多个ID）
        SELECT xo.id, CAST(NULL AS LONG) AS parent_id
        FROM XmlObject xo
        WHERE xo.id IN :rootIds

        UNION ALL

        -- 递归：查找所有子节点及其父ID
        SELECT child.id, xo.id AS parent_id
        FROM XmlObject xo
        INNER JOIN xo.childObjects child
        INNER JOIN nodes n ON xo.id = n.id
    )
    SELECT DISTINCT o, n.parent_id
    FROM nodes n
    INNER JOIN XmlObject o ON o.id = n.id
    LEFT JOIN FETCH o.xmlPeriods  -- ✅ 安全加载末级Periods（无笛卡尔积风险）
    ORDER BY n.parent_id, o.id
    """)
List findAllTreeNodesWithParentId(@Param("rootIds") Collection rootIds);

⚠️ 注意：LEFT JOIN FETCH o.xmlPeriods 是安全的，因为o是单个实体别名，不会与递归路径产生交叉乘积；而JOIN FETCH xo.childObjects在此场景下严禁使用——它会破坏递归逻辑并引发异常。

2. 手动构建内存树结构

查询返回 List

public Map buildFullTree(Collection rootIds) {
    List results = findAllTreeNodesWithParentId(rootIds);

    // 1. 按ID缓存所有节点
    Map idToNode = new HashMap<>();
    for (Object[] row : results) {
        XmlObject node = (XmlObject) row[0];
        idToNode.put(node.getId(), node);
        node.setChildObjects(new ArrayList<>()); // 初始化空列表
    }

    // 2. 建立父子关系
    Map> parentIdToChildren = new HashMap<>();
    for (Object[] row : results) {
        XmlObject node = (XmlObject) row[0];
        Long parentId = (Long) row[1];
        if (parentId != null && idToNode.containsKey(parentId)) {
            parentIdToChildren.computeIfAbsent(parentId, k -> new ArrayList<>())
                              .add(node);
        }
    }

    // 3. 关联子节点到父节点
    for (Map.Entry> entry : parentIdToChildren.entrySet()) {
        XmlObject parent = idToNode.get(entry.getKey());
        parent.getChildObjects().addAll(entry.getValue());
    }

    return idToNode;
}

3. 关键注意事项

避免@BatchSize干扰：递归CTE已一次性获取全量数据，应移除@BatchSize和@Fetch注解，防止Hibernate二次触发懒加载。
xmlPeriods加载时机：LEFT JOIN FETCH o.xmlPeriods 在CTE结果集上执行，因o为单实体，不会放大行数，完全规避了“multiple bags”问题。
性能优化：对xml_object_tree.parent_id和xml_object_tree.child_id建立联合索引；若树极深（>10层），可在CTE中添加MAXRECURSION限制（PostgreSQL用SEARCH DEPTH FIRST + CYCLE防环）。
兼容旧版Hibernate：若无法升级至6.2+，推荐集成 Blaze-Persistence，它提供@Recursive注解和类型安全的CTE构造器。