如何在单个GraphQL Mutation中实现字段差异化的实体增改？

GraphQL社区并没有绝对统一的“标准”方案，但有两种被广泛认可的实践，能更好地平衡规范合规性和客户端使用体验，比你提到的两种方案更实用：

1. 输入联合类型（Input Union） #

虽然GraphQL官方规范不支持输入类型的联合，但多数主流GraphQL服务实现（如Apollo Server、GraphQL.js的扩展插件）都提供了对输入联合的支持。你可以分别定义创建和更新的专属输入类型，再将它们组合成联合类型作为mutation的参数：

# 创建专属输入：仅需必填的name，无id
input ItemCreateInput {
  name: String!
}

# 更新专属输入：必填id，name可选更新
input ItemUpdateInput {
  id: String!
  name: String
}

# 联合输入类型
union ItemSaveInput = ItemCreateInput | ItemUpdateInput

# 定义mutation
mutation SaveItem($input: ItemSaveInput!) {
  saveItem(input: $input) {
    id
    name
  }
}

优势 #

• 客户端语义清晰，能明确传入创建或更新的输入结构，避免歧义
• 后端可直接根据输入类型分支处理逻辑，无需额外类型守卫判断
• 严格区分创建/更新的字段要求，符合GraphQL类型系统的设计思想

注意 #

• 依赖服务端对输入联合类型的支持，若使用的GraphQL实现不兼容，需换用其他方案

2. 单个输入类型+操作标识枚举 #

如果需要兼容所有GraphQL环境，可以在输入类型中加入一个明确的操作类型枚举，配合自定义验证规则来约束字段的必填性：

# 定义操作类型枚举
enum OperationType {
  CREATE
  UPDATE
}

# 统一输入类型
input ItemSaveInput {
  operation: OperationType!
  id: String # 更新时必填，创建时禁止传入
  name: String! # 创建/更新都必填
}

后端逻辑中：

• 根据operation字段判断执行创建或更新流程
• 自定义验证规则：当operation为UPDATE时，id必须非空；当operation为CREATE时，id必须为空

优势 #

• 完全兼容所有GraphQL规范实现，无依赖限制
• 客户端调用时语义明确，无需处理复杂的类型转换
• 可通过自定义验证严格约束字段组合，避免非法请求

注意 #

• 需要额外编写自定义验证逻辑，确保字段符合操作类型的要求

对比你提到的两种方案 #

• 可空类型方案：字段可空性会模糊语义，客户端容易误传非法参数（如带id的创建请求），需要额外类型守卫校验，出错风险较高
• 拆分独立属性方案：虽然符合规范，但客户端调用时需手动区分创建/更新数组，单次操作单个实体时体验冗余，不够直观

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