GraphQL中如何避免输入与输出类型间的代码重复？

嘿，很高兴看到你入坑GraphQL——这玩意儿确实值得喜欢！你遇到的这个输入类型重复的问题，是很多刚接触接口/联合类型的开发者都会碰到的坎，咱们来聊聊你的写法和优化方案~

先给你吃个定心丸：你当前的写法完全合理 #

首先要明确：GraphQL的规范里，input类型和普通type是完全独立的体系，input类型不能实现接口，也不能继承其他input（SDL原生不支持，部分框架有扩展）。所以你为每种食品类型单独定义对应的input，并且把Ingredient转换成IngredientInput的做法，是完全符合GraphQL规范的，也是保证类型安全的常规操作。

这种写法的优点很明显：前端传递参数时能得到精准的类型提示，后端也能明确接收每种食品的特定字段，编译时就能发现类型错误。唯一的缺点就是你提到的——代码重复多了点。

更优的解决方案：根据你的技术栈选合适的方式 #

如果你想减少重复代码，有几种方案可以尝试：

1. 用基础Input+扩展（框架支持的话） #

很多主流GraphQL服务端框架（比如Apollo Server、TypeGraphQL）都支持SDL的扩展语法，允许input类型继承另一个input。你可以把所有食品的公共字段提取到一个基础input，然后让其他input继承它：

# 公共基础输入
input BaseFoodInput {
  type: String!
  composition: [IngredientInput!]!
}

# 继承基础字段，只加特定字段
input PizzaInput extends BaseFoodInput {
  pizzaType: String!
  toppings: [String!]!
  size: String!
}

input SaladInput extends BaseFoodInput {
  vegetarian: Boolean!
  dressing: Boolean!
}

input BasicFoodInput extends BaseFoodInput {
  # 没有额外字段，直接继承即可
}

input IngredientInput {
  name: String!
  qty: Float!
  units: String!
}

type Mutation {
  addPizza(input: PizzaInput!): FoodType!
  addSalad(input: SaladInput!): FoodType!
  addBasic(input: BasicFoodInput!): FoodType!
}

这种方式既保留了类型安全，又大幅减少了重复代码，是我最推荐的方案——前提是你的框架支持input扩展。

2. 用单个通用Mutation+通用Input #

如果不想维护多个Mutation和Input，可以定义一个包含所有可能字段的通用Input，配合type字段做区分，然后在Resolver里做运行时校验：

type Mutation {
  addFood(input: FoodInput!): FoodType!
}

input FoodInput {
  type: String! # 用来区分食品类型，比如"PIZZA"、"SALAD"、"BASIC"
  composition: [IngredientInput!]!
  # 所有食品的可选特定字段
  pizzaType: String
  toppings: [String]
  size: String
  vegetarian: Boolean
  dressing: Boolean
}

input IngredientInput {
  name: String!
  qty: Float!
  units: String!
}

然后在Resolver中，根据input.type来校验对应的必填字段：

// 举个Resolver的例子（伪代码）
async function addFood(parent, { input }) {
  switch(input.type) {
    case "PIZZA":
      if (!input.pizzaType || !input.toppings || !input.size) {
        throw new Error("Pizza必须提供pizzaType、toppings和size字段");
      }
      // 创建Pizza逻辑
      break;
    case "SALAD":
      if (input.vegetarian === undefined || input.dressing === undefined) {
        throw new Error("Salad必须提供vegetarian和dressing字段");
      }
      // 创建Salad逻辑
      break;
    // 其他类型的校验...
  }
}

这个方案的好处是只需要一个Mutation和一个Input，代码量最少，但缺点是类型安全从编译时转移到了运行时，前端IDE会显示所有可选字段，可能造成混淆。适合对代码简洁性要求高，且能接受运行时校验的场景。

3. 用TypeScript+代码优先的框架（比如TypeGraphQL） #

如果你的项目用TypeScript，代码优先的框架能帮你从根源上减少重复。比如用TypeGraphQL，你可以用类继承来定义Input类型：

import { InputType, Field } from "type-graphql";

@InputType()
class IngredientInput {
  @Field()
  name: string;

  @Field()
  qty: number;

  @Field()
  units: string;
}

@InputType()
class BaseFoodInput {
  @Field()
  type: string;

  @Field(() => [IngredientInput])
  composition: IngredientInput[];
}

@InputType()
class PizzaInput extends BaseFoodInput {
  @Field()
  pizzaType: string;

  @Field(() => [String])
  toppings: string[];

  @Field()
  size: string;
}

@InputType()
class SaladInput extends BaseFoodInput {
  @Field()
  vegetarian: boolean;

  @Field()
  dressing: boolean;
}

TypeGraphQL会自动把这些类转换成对应的GraphQL SDL，你不需要手动写重复的Input定义，同时还能享受TypeScript的类型安全。

总结 #

你当前的写法是完全没问题的，是GraphQL规范下的标准实现。如果想减少重复，可以根据你的技术栈选择：

• 若框架支持Input扩展，优先选基础Input+扩展的方式；
• 若追求极简，可尝试通用Mutation+运行时校验；
• 若用TypeScript，代码优先的框架能帮你最大化复用代码。

内容的提问来源于stack exchange，提问作者Fred Mériot