API 设计 / 系统课时

使用 Resolver 四个参数

使用 Resolver 四个参数

GraphQL.js 的字段 Resolver 接收 parent、args、context、info 四个参数。把请求数据、父级结果、请求级依赖和执行元数据分开放置,能避免 Resolver 依赖隐式全局状态,也更容易测试和复用。

学习目标

  • 说清四个 Resolver 参数分别由谁提供
  • 为认证信息、数据库访问和字段参数选择正确位置
  • 在一个可运行示例中读取四个参数并验证结果

四个参数分别来自哪里

在 GraphQL.js 中,Resolver 形态可以理解为 resolve(parent, args, context, info)。四个参数的来源和职责不同,不应互相替代。

参数 来源 典型用途
parent 父字段 Resolver 的返回值;根字段对应 rootValue 读取当前对象已有数据,解析派生字段
args 当前字段声明的 GraphQL 参数,经校验与输入强制转换后得到 ID、筛选、分页、排序等字段输入
context 执行请求时传入的 contextValue,同一次操作的 Resolver 共享 当前用户、数据库访问对象、DataLoader、请求追踪 ID
info GraphQL 执行器生成的字段与操作元数据 字段名、父类型、返回类型、执行路径、AST、变量等

parent 是 Resolver 链的连接点,而 context 是请求级共享容器。两者最容易混淆:前者会随着字段层级变化,后者在同一次操作里通常保持为同一个对象。

用一个 Resolver 串起四个参数

下面使用 GraphQL.js 直接定义 Schema。根字段 user 同时读取四个参数,子字段 displayName 再从 parent 和 context 组合结果。示例假设当前 Node.js ESM 项目已经安装 graphql 包。

js
import {
  graphql,
  GraphQLID,
  GraphQLNonNull,
  GraphQLObjectType,
  GraphQLSchema,
  GraphQLString,
} from "graphql";

const userType = new GraphQLObjectType({
  name: "User",
  fields: {
    id: {
      type: new GraphQLNonNull(GraphQLID),
    },
    displayName: {
      type: new GraphQLNonNull(GraphQLString),
      resolve(parent, _args, context) {
        return `${parent.name} @ ${context.requestId}`;
      },
    },
  },
});

const queryType = new GraphQLObjectType({
  name: "Query",
  fields: {
    user: {
      type: new GraphQLNonNull(userType),
      args: {
        id: { type: new GraphQLNonNull(GraphQLID) },
      },
      resolve(parent, args, context, info) {
        console.log(JSON.stringify({
          parentIsRoot: parent === undefined,
          id: args.id,
          requestId: context.requestId,
          field: info.fieldName,
          parentType: info.parentType.name,
        }));

        return { id: args.id, name: "Ada" };
      },
    },
  },
});

const schema = new GraphQLSchema({ query: queryType });

const result = await graphql({
  schema,
  source: `query { user(id: "u1") { id displayName } }`,
  contextValue: { requestId: "req-42" },
});

console.log(JSON.stringify(result, null, 2));

预期输出

text
{"parentIsRoot":true,"id":"u1","requestId":"req-42","field":"user","parentType":"Query"}
{
  "data": {
    "user": {
      "id": "u1",
      "displayName": "Ada @ req-42"
    }
  }
}

根字段没有显式传入 rootValue,所以它的 parent 是 undefined;args.id 来自查询参数;context.requestId 来自本次执行传入的 contextValue;info 则由执行器创建。user 返回的对象随后成为 displayName 的 parent。

把请求级状态放进 context

认证用户、请求追踪信息和请求级 DataLoader 不应放进可变全局变量。服务同时处理多个请求时,全局可变状态可能让一个请求读到另一个请求的数据。更稳妥的做法是为每个请求创建独立 contextValue,再让该请求内的 Resolver 共享它。

数据库连接池这类进程级、线程安全或并发安全的基础设施可以在应用层复用,但“当前用户”“本次请求的 loader 缓存”“requestId”应保持请求隔离。这样 Resolver 只依赖显式参数,单元测试也可以直接构造 context。

选择参数的判断规则

字段自己的输入优先放在 args,例如 user(id:)、products(limit:);父对象已经拥有的数据从 parent 读取;与整次请求相关的认证、数据访问和批处理工具从 context 获取;只有确实需要查询结构或执行路径时才读取 info。

这四个参数形成了清晰边界:数据沿 parent 向下流,字段输入从 args 进入,请求级能力通过 context 共享,执行器元数据由 info 提供。遵守这个边界,比在 Resolver 内直接访问隐式全局状态更容易维护,也为后续做鉴权、批处理与性能治理留下稳定接口。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

使用 Resolver 四个参数

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通