Apollo Gateway在@requires含多客户端解析实体时报错

可能的代码问题点 #

1. 实体Key字段不匹配 #

确保products子图中引用的Courier实体的Key字段和couriers子图的定义完全一致（包括字段名拼写、大小写）。比如：

• couriers子图的Courier定义：

  type Courier @key(fields: "id") {
    id: ID!
    shippingCharge: Float!
    tax: Float!
  }
  

• products子图中引用Courier时必须使用相同的Key字段：

  type Product @key(fields: "id") {
    id: ID!
    courier: Courier! @key(fields: "id") # 这里的key字段要和couriers子图一致
    estimatedShippingCharge: Float! @requires(fields: "courier { shippingCharge tax }")
  }
  

如果Key字段不匹配，网关无法正确关联两个子图的Courier实体，导致依赖字段无法传递到products服务。

2. @requires的字段路径错误 #

@requires声明的字段必须是相对于当前实体的完整路径。比如在Product实体中，Courier是关联字段，那么需要明确指定路径：

# 正确写法
estimatedShippingCharge: Float! @requires(fields: "courier { shippingCharge tax }")

# 错误写法（直接写字段名，未指定关联路径）
estimatedShippingCharge: Float! @requires(fields: "shippingCharge tax")

路径错误会导致网关不会将Courier的字段传递给products服务的解析器。

3. 解析器读取数据的路径错误 #

这是最常见的问题：解析器中错误地从Product对象根级读取字段，而实际依赖的字段是嵌套在关联的Courier对象中的。

错误示例：

const resolvers = {
  Product: {
    estimatedShippingCharge(parent) {
      // 错误：shippingCharge不在parent根级，而是在parent.courier里
      return parent.shippingCharge + parent.tax;
    }
  }
};

正确示例：

const resolvers = {
  Product: {
    estimatedShippingCharge(parent) {
      // 从关联的courier对象中读取字段
      return parent.courier.shippingCharge + parent.courier.tax;
    }
  }
};

4. 字段类型不兼容 #

检查couriers子图中shippingCharge和tax的类型（如Float/Int），与products子图解析器中预期的类型是否一致。类型不兼容可能导致网关合并字段时丢失数据，或者解析器读取时出现undefined。

5. 实体扩展的字段冲突 #

如果products子图通过extend type Courier扩展了Courier实体，确保没有覆盖couriers子图中的shippingCharge或tax字段。比如：

# 错误：覆盖了couriers子图的shippingCharge字段，导致数据被替换为undefined
extend type Courier @key(fields: "id") {
  id: ID!
  shippingCharge: Float # 这里没有加!，且未提供解析逻辑，会覆盖原字段
}

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