API 设计 / 系统课时
单元测试 Resolver
单元测试 Resolver
Resolver 单元测试的目标不是启动完整 GraphQL 服务器,而是把 Resolver 当作普通函数隔离验证:显式传入参数、上下文和依赖替身,检查授权、返回值与异常路径,从而快速定位业务逻辑回归。
学习目标
- 识别 Resolver 的
parent、args、context和依赖边界 - 用依赖替身测试正常返回、授权失败和下游异常
- 避免把单元测试写成依赖数据库或 HTTP 服务的集成测试
把 Resolver 设计成可隔离函数
典型 Resolver 接收四类信息:父对象 parent、参数 args、请求上下文 context,以及通过上下文或闭包访问的数据源。单元测试应直接调用 Resolver,并替换真正的数据库、HTTP 客户端或消息系统。
下面以“只有已登录用户才能读取订单”为例。Resolver 从 context 读取当前用户和订单仓储,因此测试时无需启动 GraphQL Server。
export const resolvers = {
Query: {
order: async (_parent, { id }, context) => {
if (!context.user) {
throw new Error('UNAUTHENTICATED');
}
const order = await context.orderRepository.findById(id);
if (!order) {
throw new Error('ORDER_NOT_FOUND');
}
return order;
},
},
};这段代码本身依赖 GraphQL 运行时传入上下文,但 Resolver 函数可以被测试代码直接调用。验证重点是业务行为,而不是 schema 解析过程。
用 Node 测试运行器覆盖核心路径
下面使用 Node.js 内置的 node:test,不需要额外测试框架。仓储使用可控替身,这样每个测试都只验证 Resolver 自己的决策。
import test from 'node:test';
import assert from 'node:assert/strict';
import { resolvers } from './resolvers.mjs';
test('已登录用户可以读取订单', async () => {
const order = { id: 'o-1001', total: 99 };
const context = {
user: { id: 'u-1' },
orderRepository: {
findById: async (id) => (id === 'o-1001' ? order : null),
},
};
const result = await resolvers.Query.order(null, { id: 'o-1001' }, context);
assert.deepEqual(result, order);
});
test('未登录用户被拒绝且不会访问仓储', async () => {
let called = false;
const context = {
user: null,
orderRepository: {
findById: async () => {
called = true;
return null;
},
},
};
await assert.rejects(
() => resolvers.Query.order(null, { id: 'o-1001' }, context),
/UNAUTHENTICATED/
);
assert.equal(called, false);
});
test('订单不存在时返回明确异常', async () => {
const context = {
user: { id: 'u-1' },
orderRepository: {
findById: async () => null,
},
};
await assert.rejects(
() => resolvers.Query.order(null, { id: 'missing' }, context),
/ORDER_NOT_FOUND/
);
});执行测试:
node --test resolver.test.mjs预期输出类似:
TAP version 13
ok 1 - 已登录用户可以读取订单
ok 2 - 未登录用户被拒绝且不会访问仓储
ok 3 - 订单不存在时返回明确异常
1..3
# tests 3
# pass 3
# fail 0不同 Node.js 版本的测试报告格式可能略有差异,但应看到 3 个测试全部通过,且失败数为 0。
同时验证输入和副作用
Resolver 测试不能只断言返回值。若 Resolver 会把参数传给仓储、调用鉴权函数或写入事件,应检查这些交互是否符合预期。例如上面的未登录场景专门断言 findById 没被调用,避免授权失败后仍访问数据库。
对于输入验证,要区分两层责任:GraphQL schema 已能拦截的类型错误通常放到 API 或集成测试;Resolver 内部的业务约束,例如“只能查看自己的订单”或“状态必须允许取消”,则应放在 Resolver 单元测试中。
不要把所有 GraphQL 行为都塞进单元测试
单元测试适合验证 Resolver 的条件分支、依赖调用和异常映射,但它不能证明 schema 字段是否正确暴露、变量是否被 GraphQL 校验、错误是否按协议序列化,也不能覆盖 DataLoader 批处理等跨 Resolver 行为。
因此,Resolver 单元测试应保持快、隔离和确定;schema 解析、HTTP 传输、认证中间件以及真实数据源协作,则用少量集成测试补齐。两者边界清楚后,失败时才能快速判断是业务逻辑问题,还是 GraphQL 执行链路问题。