如何精简GraphQL中相似的Input与Type定义？

当GraphQL类型（如Person）和对应的输入类型（如PersonInput）存在大量重复字段时，可通过以下策略减少冗余、提升可维护性：

1. 拆分公共字段为复用基础定义 #

将类型和输入类型的公共字段提取为单独的基础定义，再通过SDL预处理器工具展开到目标类型中。原生GraphQL不支持直接在类型定义中复用字段片段，但可借助graphql-sdl-preprocessor这类工具实现：

# 公共字段集合
shared PersonShared {
  name: String
  dob: String
}

# 查询用类型
type Person {
  id: ID!
  ...PersonShared
}

# 输入类型（新增/编辑共用）
input PersonInput {
  id: ID
  ...PersonShared
}

预处理器会自动将shared块的字段展开到Person和PersonInput中，只需维护一份公共字段定义。

2. 用代码生成工具自动生成输入类型 #

借助GraphQL Code Generator工具，从核心类型自动生成对应的输入类型，并按需调整字段的非空约束。例如先定义核心Person类型：

# 核心查询类型定义
type Person {
  id: ID!
  name: String
  dob: String
}

通过配置@graphql-codegen/typescript等插件，可自动生成包含可选id字段的PersonInput，无需手动重复定义所有字段。

3. 利用ORM/框架的自动映射能力 #

使用TypeGraphQL、Prisma等框架时，可通过类继承复用字段定义，自动生成GraphQL类型和输入类型：

// 公共字段基类
class PersonBase {
  @Field(() => String, { nullable: true })
  name?: string;

  @Field(() => String, { nullable: true })
  dob?: string;
}

// 查询用对象类型
@ObjectType()
class Person extends PersonBase {
  @Field(() => ID)
  id: string;
}

// 输入类型
@InputType()
class PersonInput extends PersonBase {
  @Field(() => ID, { nullable: true })
  id?: string;
}

框架会自动将类转换为对应的GraphQL SDL，公共字段只需维护一次，且可灵活调整各类型的字段约束。

4. 拆分场景化输入类型 #

针对新增、编辑等不同场景拆分输入类型，避免通用输入类型的冗余：

# 公共输入字段
input PersonBaseInput {
  name: String
  dob: String
}

# 新增用输入（无需id）
input CreatePersonInput {
  ...PersonBaseInput
}

# 编辑用输入（必填id）
input UpdatePersonInput {
  id: ID!
  ...PersonBaseInput
}

# 查询用类型
type Person {
  id: ID!
  ...PersonBaseInput
}

此方式不仅减少重复定义，还能让输入类型的语义更清晰，避免字段约束模糊的问题（需借助SDL预处理器支持输入类型的片段引用）。

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