如何编写递归GraphQL查询获取多级产品分类直至无父分类？

问题背景 #

我有如下GraphQL查询，用于获取产品的嵌套分类信息：

query MyQuery {
  product(uid: "1234") {
    productCategoryConnection: product_categoryConnection {
      edges {
        node {
          ... on ProductCategory {
            title
            identifier
            parentCategoryConnection: parent_categoryConnection {
              edges {
                node {
                  ... on ProductCategory {
                    title
                    identifier
                    parentCategoryConnection: parent_categoryConnection {
                      edges {
                        node {
                          ... on ProductCategory {
                            title
                            identifier
                            parentCategoryConnection: parent_categoryConnection {
                              edges {
                                node {
                                  ... on ProductCategory {
                                    title
                                    identifier
                                  }
                                }
                              }
                            }
                          }
                        }
                      }
                    }
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}

产品分类的嵌套层级不固定，部分场景层级较少，部分场景层级更深。我希望编写递归查询，自动遍历到没有父分类（即edges为空数组）的层级为止。

尝试用片段递归实现时，触发了栈溢出错误：

query MyQuery {
  product(uid: "blt742f17e9dfed750e", locale: "en-us") {
    productCategoryConnection: product_categoryConnection {
      edges {
        node {
          ...ProductCategoryFields
        }
      }
    }
  }
}

fragment ProductCategoryFields on ProductCategory {
  title
  identifier
  parentCategoryConnection: parent_categoryConnection {
    edges {
      node {
        ...NestedProductCategoryFields
      }
    }
  }
}

fragment NestedProductCategoryFields on ProductCategory {
  title
  identifier
  parentCategoryConnection: parent_categoryConnection {
    edges {
      node {
        ...ProductCategoryFields
      }
    }
  }
}

返回的错误信息：

{
  "errors": [
    {
      "message": "Maximum call stack size exceeded",
      "extensions": {}
    }
  ]
}

请问是否可以编写这样的递归查询，还是必须手动嵌套parentCategoryConnection？

问题分析与解决方案 #

为什么会出现栈溢出？ #

GraphQL的片段不支持循环引用的递归解析。ProductCategoryFields和NestedProductCategoryFields互相引用，服务器在解析查询时会无限循环调用这两个片段，最终触发栈溢出错误。GraphQL规范要求查询结构在执行前必须确定固定的深度，无法自动处理未知层级的递归遍历。

可行的替代方案 #

1. 服务器端新增扁平化路径字段（最优解）

如果能修改GraphQL服务器的Schema，建议新增一个类似fullCategoryPath的字段，直接返回产品的完整分类路径数组（从子分类到根分类）。这样客户端只需查询该字段，就能一次性获取所有层级的分类信息，无需处理嵌套查询。

示例返回结构：

{
  "data": {
    "product": {
      "fullCategoryPath": [
        {"title": "Sub-category 1", "identifier": "sub-category-1"},
        {"title": "Category 1", "identifier": "category-1"},
        {"title": "Root Category", "identifier": "root-category"}
      ]
    }
  }
}

2. 客户端动态拼接查询

如果无法修改服务器，可以在客户端分步骤查询：

• 先查询产品的直接分类
• 检查返回结果中是否有非空的parentCategoryConnection.edges
• 若存在父分类，继续发起查询获取父分类信息，直到edges为空
• 最后在客户端将所有层级的分类数据拼接成完整路径

3. 手动嵌套固定层级（兼容方案）

如果能预估业务场景中的最大分类层级，可以手动嵌套对应层数的查询，确保覆盖所有可能的情况。示例：

query MyQuery {
  product(uid: "1234") {
    productCategoryConnection {
      edges {
        node {
          ...ProductCategoryLevel1
        }
      }
    }
  }
}

fragment ProductCategoryLevel1 on ProductCategory {
  title
  identifier
  parentCategoryConnection {
    edges {
      node {
        ...ProductCategoryLevel2
      }
    }
  }
}

fragment ProductCategoryLevel2 on ProductCategory {
  title
  identifier
  parentCategoryConnection {
    edges {
      node {
        ...ProductCategoryLevel3
      }
    }
  }
}

# 根据业务需求添加更多层级片段

结论 #

GraphQL本身不支持自动遍历未知深度的嵌套结构，无法通过片段循环引用实现递归查询。优先选择修改服务器Schema提供扁平化路径字段，其次考虑客户端动态查询拼接，或手动嵌套足够覆盖业务场景的层级。

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