API 设计 / 系统课时

抽象 Resolver 数据源

抽象 Resolver 数据源

Resolver 最容易失控的地方,不是 GraphQL 语法,而是把 SQL、HTTP 请求、鉴权和错误处理全塞进字段函数。本课把数据访问下沉到 repository 与 data source,让 Resolver 只保留参数解释、权限边界和结果组装,并用可运行示例验证这种分层。

学习目标

  • 区分 Resolver、Repository 与 Data Source 的职责边界
  • 用依赖注入让 Resolver 脱离具体数据库和上游 API
  • 判断事务、错误转换和请求级状态应该放在哪一层

Resolver 只处理 GraphQL 边界

Resolver 的输入是父对象、GraphQL 参数、请求上下文和字段信息,它最适合处理“这个字段该调用哪个业务能力”,不适合直接承担连接池、SQL 拼接、HTTP 重试或供应商协议细节。否则同一种数据访问很快会散落在多个字段中,测试也必须同时启动数据库或上游服务。

一个实用边界是:Repository 封装数据库语义,例如“按 ID 取商品”;Data Source 封装外部服务语义,例如“查询库存”;Resolver 只组合这些能力。这样更换 PostgreSQL 驱动或库存服务地址时,不需要改 GraphQL 字段定义。

Resolver 到数据源的职责分层

用依赖注入拆开数据库与上游 API

下面是一个可独立运行的最小示例。它直接调用与常见 GraphQL 服务器一致的 Resolver 函数签名,并用内存 mock 代替真实数据库和 HTTP 服务,因此无需安装框架即可观察分层效果。

js
class ProductRepository {
  constructor(db) {
    this.db = db;
  }

  async findById(id) {
    const row = await this.db.queryOne("SELECT id, sku, name FROM products WHERE id = ?", [id]);
    return row ?? null;
  }
}

class InventoryDataSource {
  constructor(fetchImpl, baseUrl) {
    this.fetchImpl = fetchImpl;
    this.baseUrl = baseUrl;
  }

  async getStock(sku) {
    const response = await this.fetchImpl(`${this.baseUrl}/stocks/${sku}`);
    if (!response.ok) throw new Error("inventory unavailable");
    return (await response.json()).stock;
  }
}

const resolvers = {
  Query: {
    product: (_parent, { id }, context) => context.products.findById(id),
  },
  Product: {
    stock: (product, _args, context) => context.inventory.getStock(product.sku),
  },
};

async function main() {
  const db = {
    queryOne: async (_sql, [id]) =>
      id === "p1" ? { id: "p1", sku: "SKU-1", name: "Keyboard" } : null,
  };
  const fetchImpl = async () => ({
    ok: true,
    json: async () => ({ stock: 12 }),
  });

  const context = {
    products: new ProductRepository(db),
    inventory: new InventoryDataSource(fetchImpl, "https://inventory.example"),
  };

  const product = await resolvers.Query.product(null, { id: "p1" }, context);
  const stock = await resolvers.Product.stock(product, {}, context);
  console.log(JSON.stringify({ ...product, stock }));
}

main().catch(console.error);

预期输出:

json
{"id":"p1","sku":"SKU-1","name":"Keyboard","stock":12}

这里的 Resolver 不知道 SQL 驱动、表结构之外的查询细节,也不知道库存 API 如何重试或解析错误;测试 Resolver 时只要替换 context.products 与 context.inventory 即可。实际接入 Apollo Server、GraphQL Yoga 等框架时,把这些依赖放进请求上下文即可复用同一模式。

让请求级状态待在 Context

连接池、无用户状态的 Repository 可以长期复用,但带有当前用户令牌、租户 ID、请求级缓存或 DataLoader 的对象应按请求创建,并通过 Context 传入。这样可以避免把 A 用户的认证信息或缓存结果泄漏给 B 用户。

如果一次 GraphQL mutation 需要跨多个 Repository 保持原子性,事务边界通常由更高一层的 service/use-case 控制,再把同一个事务句柄传给 Repository;不要让多个 Resolver 各自偷偷开启事务。

把错误与数据协议留在边界内

Repository 应把数据库驱动的行结构转换成领域对象,Data Source 应屏蔽上游状态码、字段命名和重试策略;Resolver 再把可预期的业务错误转换成 GraphQL 能表达的错误或可空结果。这样字段层看到的是稳定的数据契约,而不是 PostgreSQL 错误码或供应商私有响应。

判断分层是否有效,可以做一个简单检查:把数据库实现替换成内存对象、把上游 API 替换成 stub 后,Resolver 测试仍然不需要改字段逻辑;如果做不到,说明具体数据访问细节仍然泄漏到了 GraphQL 层。

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

目录与阅读设置

阅读设置

17

记录一个想法

抽象 Resolver 数据源

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

登录哪都通