GraphQL多类型参数查询疑问：where参数支持两种可选类型吗？

你的这种直接用Person | Company作为查询参数类型的写法不被GraphQL官方规范支持。

原因说明 #

GraphQL的类型系统中，联合类型（Union）仅允许用于输出类型（比如接口返回的字段类型），不能直接作为输入参数的类型。输入参数只能指定单一的命名输入类型（Input Type），因此where: Person | Company这种语法在标准GraphQL中是无效的。

两种可行的替代方案 #

方案1：带鉴别器的单一输入类型（兼容所有GraphQL实现）

定义一个包含类型鉴别器的输入类型，通过枚举字段明确指定当前使用的是Person还是Company条件，同时提供对应的子输入字段：

enum SearchEntityType {
  PERSON
  COMPANY
}

input Person {
  name: String
  email: String
}

input Company {
  name: String
  domain: String
}

input SearchWhereInput {
  type: SearchEntityType!
  person: Person
  company: Company
}

type GetSearch {
  name: String
  email: String
  domain: String
}

extend type Query {
  getSearch(where: SearchWhereInput): [GetSearch]
}

客户端调用时，需要同时指定type和对应的子字段：

query {
  getSearch(where: {
    type: PERSON
    person: { name: "Alice", email: "alice@example.com" }
  }) {
    name
    email
  }
}

方案2：使用输入联合类型扩展（部分服务端支持）

虽然标准GraphQL不支持输入联合，但部分服务端实现（如Apollo Server、GraphQL Nexus）通过扩展语法或指令支持类似功能。比如Apollo Server的@oneOf指令（需要GraphQL 16+），可以实现“输入中仅允许一个字段被赋值”的效果：

input Person {
  name: String
  email: String
}

input Company {
  name: String
  domain: String
}

input SearchWhereInput {
  person: Person
  company: Company
} @oneOf

type GetSearch {
  name: String
  email: String
  domain: String
}

extend type Query {
  getSearch(where: SearchWhereInput): [GetSearch]
}

客户端调用时只需传入其中一个字段：

query {
  getSearch(where: {
    company: { name: "Acme Corp", domain: "acme.com" }
  }) {
    name
    domain
  }
}

总结 #

• 直接用Person | Company作为参数类型不被标准支持；
• 优先选择带鉴别器的单一输入类型，确保兼容性；
• 如果使用特定服务端框架，可以尝试其提供的输入联合扩展方案。

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