GraphQL中如何防止/消除重复字段？是否属于反模式？

重复字段是否属于反模式？ #

是。虽然GraphQL规范允许查询重复字段，且返回结果不会重复输出相同字段的值，但这绝对是一种反模式——重复字段会触发多次字段解析逻辑（如果字段有自定义resolver），额外消耗服务器计算资源、数据库查询次数等，徒增不必要的运行成本。

比如你示例中的查询：

query Viewer { me { id id id id id id id id id id } }

即使id字段的resolver只是简单返回数据，重复10次也会让服务器执行10次相同的解析操作，完全是资源浪费。

最佳处理方式 #

1. 客户端层面：从源头避免重复

• 团队规范+静态检查：在团队内明确禁止查询重复字段，代码评审时重点排查；借助ESLint的eslint-plugin-graphql插件配置规则，在开发阶段自动检测并报错重复字段，从编码环节杜绝问题。
• 使用GraphQL片段（Fragments）：把常用的字段组合封装成片段，复用片段来避免手动重复书写字段。示例：

fragment UserBasicInfo on User {
  id
}

query Viewer {
  me { ...UserBasicInfo }
}

片段不仅能避免重复，还能提升查询的可维护性。

2. 服务端层面：用GraphQL-Yoga拦截重复字段请求

通过自定义GraphQL验证规则，在请求进入解析阶段前就拦截带有重复字段的查询，直接返回错误，避免资源消耗。

以下是针对GraphQL-Yoga的实现代码：

首先定义自定义验证规则：

import { GraphQLError } from 'graphql';

// 禁止重复字段的验证规则
function NoDuplicateFieldsRule(context) {
  return {
    Field(node) {
      const parentType = context.getParentType();
      const fieldName = node.name.value;
      // 获取当前父节点下的所有字段选择
      const siblingFields = context.getFieldDef()?.astNode?.selectionSet?.selections || [];
      // 统计当前字段的重复次数
      const duplicateCount = siblingFields.filter(
        selection => selection.kind === 'Field' && selection.name.value === fieldName
      ).length;

      if (duplicateCount > 1) {
        context.reportError(
          new GraphQLError(
            `字段 "${fieldName}" 在父类型 "${parentType.name}" 下重复出现`,
            { nodes: node }
          )
        );
      }
    }
  };
}

然后在GraphQL-Yoga的配置中引入该规则：

import { createYoga, createServer } from 'graphql-yoga';
import { schema } from './your-schema-file'; // 替换为你的schema路径

const yoga = createYoga({
  schema,
  // 把自定义规则加入默认验证规则集合
  validationRules: (existingRules) => [...existingRules, NoDuplicateFieldsRule]
});

const server = createServer(yoga);
server.listen(4000, () => {
  console.log('GraphQL服务运行在 http://localhost:4000/graphql');
});

配置完成后，当客户端发送带有重复字段的查询时，服务器会直接返回验证错误，拒绝执行该请求。

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