基于graphql-js的Node项目：GraphQL拒绝未知字段的解决方案咨询

我完全懂你的困扰——Apollo Client自动给对象加上的__typename字段，确实经常在和graphql-js后端对接时添乱，默认的严格字段校验直接就把请求拒了，手动清理对象实在太麻烦。分享几个我在项目里亲测好用的最优解法，不用再手动处理：

方案一：后端放宽未知字段校验（最省心） #

graphql-js的默认验证规则里，有一个KnownInputFieldNamesRule会检查输入对象里的未知字段并报错。我们只需要移除这个规则，就能让后端忽略掉多余的__typename（以及其他未知字段）。

具体实现 #

如果是直接使用graphql-js的validate和execute方法：

const { validate, specifiedRules, KnownInputFieldNamesRule } = require('graphql');

// 从默认规则中移除未知输入字段检查
const customValidationRules = specifiedRules.filter(rule => rule !== KnownInputFieldNamesRule);

// 在执行查询前，用自定义规则验证
const validationErrors = validate(yourSchema, queryDocument, customValidationRules);
if (validationErrors.length === 0) {
  // 执行查询逻辑
  const result = await execute({
    schema: yourSchema,
    document: queryDocument,
    variableValues: variables,
  });
}

如果用的是Apollo Server，直接在配置里传入自定义验证规则即可：

const { ApolloServer } = require('@apollo/server');
const { specifiedRules, KnownInputFieldNamesRule } = require('graphql');

const server = new ApolloServer({
  schema: yourSchema,
  validationRules: specifiedRules.filter(rule => rule !== KnownInputFieldNamesRule),
});

优点：一劳永逸，前端完全不用改；缺点：会失去对输入字段拼写错误的校验，如果用户传了错误的字段名，后端不会报错提示。

方案二：前端自动清理__typename（保持后端严格校验） #

如果不想放宽后端的校验规则，我们可以让Apollo Client在发送请求前自动移除变量里的__typename字段。最优雅的方式是通过transformRequest钩子全局处理。

具体实现 #

首先实现一个递归清理__typename的工具函数（也可以用lodash的omitDeep之类的库）：

// 递归移除对象/数组中的__typename字段
const removeTypenames = (data) => {
  if (Array.isArray(data)) {
    return data.map(item => removeTypenames(item));
  }
  if (typeof data === 'object' && data !== null) {
    const { __typename, ...rest } = data;
    // 递归处理剩下的字段
    return Object.fromEntries(
      Object.entries(rest).map(([key, value]) => [key, removeTypenames(value)])
    );
  }
  return data;
};

然后在创建Apollo Client的HTTP链接时配置transformRequest：

import { ApolloClient, InMemoryCache, createHttpLink } from '@apollo/client';

const httpLink = createHttpLink({
  uri: '/your-graphql-endpoint',
  transformRequest: (operation) => {
    // 清理变量中的__typename
    operation.variables = removeTypenames(operation.variables);
    return operation;
  },
});

const client = new ApolloClient({
  link: httpLink,
  cache: new InMemoryCache(),
});

优点：后端保持严格校验，能及时发现输入字段的错误；缺点：需要前端额外配置，但一次配置后所有请求都会自动处理，不用再手动清理。

方案三：自定义输入类型的解析器（进阶） #

如果以上两种方案都不符合你的需求，还可以通过自定义输入类型的解析逻辑，在解析时忽略未知字段。比如用graphql-tools的transformSchema来包装原schema，对输入对象进行清理：

const { transformSchema, wrapInputFields } = require('@graphql-tools/wrap');

const schemaWithIgnoredUnknownFields = transformSchema(yourSchema, {
  wrapInputFields: (fieldConfig) => {
    return {
      ...fieldConfig,
      parseValue: (value) => {
        // 解析值时移除__typename
        if (typeof value === 'object' && value !== null) {
          const { __typename, ...cleaned } = value;
          return cleaned;
        }
        return value;
      },
    };
  },
});

这个方案比较灵活，但实现起来稍复杂，适合需要更精细控制的场景。

总结 #

• 如果团队能接受放宽后端校验，方案一是最省心的选择；
• 如果要保持后端的严格校验，方案二是最优解，一次配置全局生效；
• 手动清理对象是最不推荐的方式，尽量用自动化方案替代。

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