如何调试Apollo GraphQL：定位未提供必填$id变量的查询

一、增强客户端ErrorLink，打印完整请求上下文 #

修改你的errorLink，加入对请求操作信息的打印——onError回调的参数包含operation对象，里面有操作名称、传入的变量和查询语句，这些信息能直接帮你定位出错的查询：

// 先导入graphql的print函数，用于把查询AST转为字符串
import { print } from 'graphql';
import util from 'util';
import { onError } from '@apollo/client/link/error';

const errorLink = onError(({ graphQLErrors, operation }) => {
  if (graphQLErrors) {
    graphQLErrors.forEach((err) => {
      console.log('=== GraphQL 错误详情 ===');
      console.log('操作名称:', operation.operationName);
      console.log('传入变量:', operation.variables);
      console.log('查询语句:', print(operation.query));
      console.log('错误信息:', util.inspect(err, { showHidden: false, depth: 3, colorize: true }));
    });
  }
});

运行后，控制台会直接输出出错查询的名称和内容，你可以根据operationName在项目中快速搜索到对应的查询定义。

二、服务器端添加请求日志（若有权限修改） #

在Apollo Server中添加请求日志插件，记录每个请求的关键信息，从服务器端定位出错请求：

import { ApolloServer } from '@apollo/server';

const server = new ApolloServer({
  typeDefs,
  resolvers,
  plugins: [
    {
      requestDidStart() {
        return {
          didResolveOperation(context) {
            console.log(`[GraphQL 请求] 操作名称: ${context.operationName}`);
            console.log(`[GraphQL 请求] 传入变量: ${JSON.stringify(context.request.variables)}`);
            console.log(`[GraphQL 请求] 查询语句: ${context.request.query}`);
          }
        };
      }
    }
  ]
});

当错误发生时，查看服务器日志，找到variables中缺少$id的请求，对应的operationName就是出错的查询。

三、利用浏览器工具定位请求 #

如果之前用Apollo DevTools没拿到有效信息，试试这些操作：

• 确认Apollo DevTools已连接到客户端（浏览器控制台的Apollo标签，检查客户端是否被正确识别）
• 开启DevTools的「Log Results」和「Log Errors」选项，错误会附带完整请求信息打印到控制台
• 查看浏览器DevTools的Network面板：筛选「graphql」类型请求，查看每个请求的Payload，找到variables中没有id的请求，对应的operationName就是目标查询

四、静态检查提前规避错误 #

用ESLint的eslint-plugin-graphql插件，在开发阶段就识别出未传必填变量的问题：

1. 安装依赖：npm install eslint-plugin-graphql --save-dev
2. 在ESLint配置文件中添加规则：

{
  "plugins": ["graphql"],
  "rules": {
    "graphql/template-strings": ["error", {
      "env": "apollo",
      "schemaJsonFilepath": "./schema.json" // 替换为你的GraphQL schema文件路径
    }]
  }
}

配置后，IDE会在编写代码时直接提示哪些查询未传入必填变量，避免运行时出错。

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