如何在GraphQL中合并两种类型以解决查询字段报错问题？

问题原因 #

你定义的CityVendor Union类型只是City和Vendor的类型联合，Union本身不包含任何字段——它仅表示返回结果属于这两种类型中的某一种。当你直接查询name字段时，GraphQL无法确定你要获取的是City的name还是Vendor的name，因此抛出报错。

两种可行解决方案 #

方案1：使用内联片段（Inline Fragment）查询Union类型

这是Union类型的标准用法，通过... on 类型名的语法明确指定不同类型对应的字段：

query GetNearbyVendors {
  nearby_vendors {
    ... on Vendor {
      name
      address
      # 其他Vendor独有的字段
    }
    ... on City {
      name
      population
      # 其他City独有的字段
    }
  }
}

执行查询时，GraphQL会根据返回数据的实际类型，自动匹配对应的片段字段进行解析。

方案2：用Interface（接口）替代Union（适用于有共同字段的场景）

如果City和Vendor存在一批共同字段（比如都有id、name），可以定义一个接口让两者实现，这样既能直接查询共同字段，又能通过片段获取各自的独有字段：

首先定义接口和类型：

# 定义包含共同字段的接口
interface NamedEntity {
  id: ID!
  name: String!
}

# City实现接口
type City implements NamedEntity {
  id: ID!
  name: String!
  population: Int! # City独有字段
}

# Vendor实现接口
type Vendor implements NamedEntity {
  id: ID!
  name: String!
  address: String! # Vendor独有字段
}

# 修改查询返回类型为接口数组
type Query {
  nearby_vendors: [NamedEntity!]!
}

然后编写查询：

query GetNearbyVendors {
  nearby_vendors {
    # 直接查询接口定义的共同字段
    id
    name
    # 用片段查询各自的独有字段
    ... on Vendor {
      address
    }
    ... on City {
      population
    }
  }
}

总结 #

GraphQL是强类型查询语言，不存在直接“合并两种类型”让你无差别查询所有字段的写法。如果只是需要返回两种异构数据，用Union加内联片段即可；如果两者有共同字段，Interface会是更优雅的选择。

内容的提问来源于stack exchange，提问作者Get Off My Lawn