API 设计 / 系统课时

单元测试 Resolver

单元测试 Resolver

Resolver 单元测试的目标不是启动完整 GraphQL 服务器,而是把 Resolver 当作普通函数隔离验证:显式传入参数、上下文和依赖替身,检查授权、返回值与异常路径,从而快速定位业务逻辑回归。

学习目标

  • 识别 Resolver 的 parent、args、context 和依赖边界
  • 用依赖替身测试正常返回、授权失败和下游异常
  • 避免把单元测试写成依赖数据库或 HTTP 服务的集成测试

把 Resolver 设计成可隔离函数

典型 Resolver 接收四类信息:父对象 parent、参数 args、请求上下文 context,以及通过上下文或闭包访问的数据源。单元测试应直接调用 Resolver,并替换真正的数据库、HTTP 客户端或消息系统。

下面以“只有已登录用户才能读取订单”为例。Resolver 从 context 读取当前用户和订单仓储,因此测试时无需启动 GraphQL Server。

js
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 自己的决策。

js
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/
  );
});

执行测试:

bash
node --test resolver.test.mjs

预期输出类似:

text
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 执行链路问题。

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

目录与阅读设置

阅读设置

17

记录一个想法

单元测试 Resolver

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

登录哪都通