GraphQL CodeGen：单请求批量执行任意次数相同突变

首先直接给你结论：用CodeGen生成的静态客户端，确实没办法在单请求里动态执行任意数量的同名mutation——因为CodeGen是基于你预先写死的GraphQL操作生成代码的，它的操作都是静态定义好的，没法动态拼接多个相同mutation到一个请求里（除非你提前固定好数量写死，但这显然满足不了“动态数量”的需求）。

不过你有几个不用改Schema就能实现单请求批量复制的替代方案，还有最规范的长期方案，我给你逐一拆解：

方案1：绕开CodeGen，手动构造多mutation请求 #

虽然CodeGen生成的服务是静态的，但你可以在项目里单独写个工具函数，自己构建包含多个duplicateProduct mutation的请求体，然后直接用HTTP客户端发送（不用CodeGen生成的mutation方法）。

举个例子，动态生成的请求体大概是这样：

mutation DuplicateProducts($ids: [ID!]!) {
  product_0: duplicateProduct(productID: $ids[0]) { id }
  product_1: duplicateProduct(productID: $ids[1]) { id }
  # 循环生成对应数量的带别名的mutation字段
}

这里的关键是给每个mutation字段加唯一的别名（比如product_0、product_1），这样GraphQL服务器能区分每个操作的结果。你可以用代码根据传入的ID数组动态拼接这个请求字符串，再把ID数组作为变量传进去。

这种方式不用改Schema，也能在单请求里完成批量操作，唯一的缺点是没法利用CodeGen的类型安全优势——如果你的项目对类型要求没那么严格，或者你能自己处理返回结果的类型，这是个快速解决的办法。

方案2：预生成固定数量的批量操作（灵活性差） #

如果能接受批量数量是有限的几个固定值（比如最多一次复制5个），可以提前在GraphQL文件里写好带别名的多个mutation，比如：

mutation DuplicateUpTo5Products($id1: ID!, $id2: ID!, $id3: ID!, $id4: ID!, $id5: ID!) {
  p1: duplicateProduct(productID: $id1) { id }
  p2: duplicateProduct(productID: $id2) { id }
  p3: duplicateProduct(productID: $id3) { id }
  p4: duplicateProduct(productID: $id4) { id }
  p5: duplicateProduct(productID: $id5) { id }
}

然后让CodeGen生成对应的服务方法。但这种方式只能覆盖特定数量的场景，完全不支持动态数量，实用性不强，只适合临时救急。

最符合GraphQL规范的方案：修改Schema添加批量mutation #

如果从长期维护和GraphQL最佳实践来看，重新设计Schema添加批量复制的mutation才是最优解，原因有这几点：

• 类型安全拉满：CodeGen可以完美生成类型化的批量操作方法，不用手动拼接请求，完全避免类型错误。
• 服务器端更高效：服务器可以针对批量操作做统一的事务处理、数据库批量查询等优化，比处理多个独立mutation性能更好，逻辑更清晰。
• API语义更明确：批量复制是一个明确的业务操作，单独的mutation更符合GraphQL“面向业务语义”的设计原则，其他开发者看API就能明白用途，可读性更强。

修改后的Schema大概是这样：

type Mutation {
  duplicateProduct(productID: ID!): Product
  # 新增批量复制的mutation
  duplicateProducts(productIDs: [ID!]!): [Product!]!
}

对应的mutation操作就是：

mutation DuplicateProducts($productIDs: [ID!]!) {
  duplicateProducts(productIDs: $productIDs) { id }
}

这种方式虽然需要修改Schema和服务器实现，但从长期来看是最健壮、最易维护的方案。

总结一下 #

• 不想改Schema的话，只能绕开CodeGen的静态限制，手动动态构建多mutation请求；
• 追求规范和长期维护，修改Schema添加批量mutation是最好的选择。

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