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 包。
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));预期输出
{"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 内直接访问隐式全局状态更容易维护,也为后续做鉴权、批处理与性能治理留下稳定接口。