GraphQL：无需显式...on查询获取解析后Union类型字段可行吗？

这是个很常见的困惑——毕竟你定义的每个ContentUnion成员类型都有id字段，为啥必须用...on片段才能查询呢？核心原因在于GraphQL联合类型的本质：它只是多个类型的集合，本身并不继承或共享成员类型的字段。类型解析器的作用确实是告诉GraphQL服务器“这次返回的是哪个具体类型”，但它没法改变GraphQL的查询验证规则——联合类型本身没有id字段，所以直接查询id会触发验证错误。

不过别担心，有几种方法能实现你想要的简化查询效果：

1. 改用接口类型（最优方案） #

如果你的所有成员类型（Content/Setting/Page/Picture）都共享一些字段（比如id、doctype），那么接口类型就是为这种场景设计的。接口可以定义所有实现类型必须包含的共享字段，查询时可以直接在接口上查询这些共享字段，不需要额外的片段。

步骤： #

首先定义一个包含共享字段的接口：

interface ContentInterface {
  id: String!
  doctype: String!
}

然后让每个类型都实现这个接口：

type Setting implements ContentInterface {
  id: String!
  doctype: String!
  name: String!
}

// 同样让Content、Page、Picture都实现ContentInterface
type Content implements ContentInterface {
  id: String!
  doctype: String!
  // 其他Content专属字段
}

最后把你的查询返回类型调整为ContentInterface（替换原来的ContentUnion），这样就可以直接查询共享字段了：

{
  content(id: "113804") {
    id
    doctype
    // 如果需要查询某个类型的专属字段，再用片段
    ... on Setting {
      name
    }
  }
}

这种方式完全符合GraphQL的规范，既简化了共享字段的查询，又保留了类型专属字段的查询能力。

2. 复用片段（如果不想修改类型定义） #

如果暂时没法把联合类型改成接口，你可以定义一个包含所有成员类型片段的复用片段，减少重复代码：

# 定义复用片段
fragment SharedIdFields on ContentUnion {
  ... on Content { id }
  ... on Setting { id }
  ... on Page { id }
  ... on Picture { id }
}

# 查询时直接引用
{
  content(id: "113804") {
    ...SharedIdFields
  }
}

这种方式不用修改类型定义，但本质还是用了片段，只是通过复用减少了重复书写。

3. 注意：避免非标准扩展 #

有些GraphQL服务器（比如Apollo Server）支持一些自定义扩展或插件，但这些属于非标准功能，会降低查询的可移植性，不推荐在生产环境使用。

总结一下：如果你的类型有共享字段，接口是最适合的解决方案；如果没有共享字段，联合类型才是正确选择，这时候就必须用...on片段来查询具体类型的字段。

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