使用GraphQL Fusion关联两个子图查询失败问题排查

核心问题：Review子图的@lookup指令配置不完整 #

你的Review子图中，扩展Product的reviews字段时，@lookup指令未明确指定要调用的查询操作（即reviewsByProductId），导致网关无法识别关联数据的获取逻辑，进而触发执行错误。

修复步骤：修改Review子图的Schema #

将Review子图中extend type Product部分的@lookup指令补充完整，明确查询目标与参数映射关系：

extend type Product {
  reviews: [Review!]! @lookup(query: "reviewsByProductId", by: "id", argument: "productId")
}

• query: "reviewsByProductId"：指定调用当前子图的reviewsByProductId查询接口获取评论数据
• by: "id"：使用Product对象的id字段作为关联匹配的键值
• argument: "productId"：将Product的id值传递给reviewsByProductId查询的productId参数

其他排查要点 #

1. 验证解析器逻辑正确性

   • 确认reviewsByProductId解析器能正确接收productId参数，且返回对应产品的评论列表，无空指针、数据查询异常等问题
   • 确认Product子图的products解析器能正常返回所有产品数据

2. 查看详细错误日志
   仅返回Unexpected Execution Error无法定位具体问题，需查看GraphQL Fusion网关或子图的服务日志，获取完整异常栈，排查方向包括：

   • 是否找不到指定的查询操作
   • 参数映射是否失败
   • 子图服务调用是否超时或报错

3. 检查网关合并配置

   • 确认两个子图已正确注册到网关，网关能正常拉取并合并各子图的Schema
   • 验证网关是否支持@lookup指令的完整语法，部分网关可能需要额外配置指令的处理逻辑

验证修复结果 #

修改Schema并重启服务后，重新执行目标查询语句，应能得到预期的结构化结果：

{
  "data": {
    "products": [
      {
        "id": "1",
        "name": "Product A",
        "reviews": [
          { "comment": "Excellent", "productId": "1", "rating": 5 },
          { "comment": "Very Good", "productId": "1", "rating": 4 }
        ]
      },
      {
        "id": "2",
        "name": "Product B",
        "reviews": [
          { "comment": "Average", "productId": "2", "rating": 3 }
        ]
      }
    ]
  }
}

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