如何复用GraphQL类型的部分字段？解决更新返回字段冗余问题

问题背景 #

原始GraphQL Schema如下：

type User {
  name: String
  location: Location
}

type Organization {
  industry: String
  size: Int
  user: User
}

type Query {
  organization: Organization
}

type Mutation {
  updateOrganization(industry: String, size: Int): Organization
}

需求是调用updateOrganization这个mutation时，返回结果不需要包含user字段，想实现类似TypeScript中Omit<Organization, 'user'>的效果。

尝试过的方案及问题 #

曾尝试用接口拆分类型，代码如下：

interface OrganizationFields implements Node {
  industry: String
  size: Int
}

type Organization implements OrganizationFields {
  user: User
}

type Mutation {
  updateOrganization(industry: String, size: Int): OrganizationFields
}

但这个方案存在问题：返回OrganizationFields类型时，必须显式指定__typename为Organization，这就要求必须同时返回user字段，完全达不到预期效果。

可行的解决方法 #

方法一：创建专属返回类型 #

直接定义一个不含user字段的新类型，比如OrganizationUpdateResult：

type OrganizationUpdateResult {
  industry: String
  size: Int
}

type Mutation {
  updateOrganization(industry: String, size: Int): OrganizationUpdateResult
}

这种方式最直接，类型边界清晰，返回时只需要提供industry和size两个字段即可，完全满足需求，没有额外的多态处理成本。

方法二：利用GraphQL字段选择特性（推荐） #

GraphQL本身支持客户端在请求时自主选择需要的字段，不需要修改原有Schema。比如调用mutation时，只请求需要的字段：

mutation {
  updateOrganization(industry: "Tech", size: 100) {
    industry
    size
  }
}

服务端只需要返回这两个字段，客户端也不会拿到user字段。如果想强制服务端不返回user，可以在Resolver逻辑里过滤掉该字段，但Schema层面仍保留Organization类型，这种方式更灵活，无需额外定义新类型。

注意：GraphQL原生并不支持类似TypeScript的Omit这类类型操作符，所以没法直接写Omit<Organization, 'user'>作为返回类型。

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