SuperAPI AI 工具集

graphql

编程与开发

查看项目

更新于 11-11 16:17

技能介绍

GraphQL 让客户端精确获取所需数据,只有一个端点、类型化 schema 并支持内省,但灵活性也带来风险。该技能覆盖 schema 设计、resolvers、DataLoader 防 N+1、微服务联邦、订阅、客户端集成(Apollo/urql)、代码生成等。核心观点:schema 即契约,应精心设计;用 DataLoader 批量加载;限制查询深度与复杂度;预期错误用 union 类型作为数据返回;nullability 需有意设计。

能力包括 graphql-schema-design、graphql-resolvers、graphql-federation、graphql-subscriptions、graphql-dataloader、graphql-codegen,以及 apollo-server、apollo-client、urql。工具方面:服务端可选 @apollo/server(Apollo Server v4,最流行)、graphql-yoga(轻量、适合 serverless)、mercurius(Fastify 集成、使用 JIT);客户端可选 @apollo/client(全功能、带缓存与状态管理)、urql(更轻量)、graphql-request(极简、无缓存);工具包括 graphql-codegen(TypeScript 类型生成)、dataloader(批处理与缓存)。

使用方式上,资料给出 schema 设计示例(含 Query、Mutation、Subscription、输入类型、payload union、枚举、Relay 风格分页)、DataLoader 按请求创建并按输入顺序返回结果的实现、Apollo Client 规范化缓存与 typePolicies、graphql-codegen 配置与生成命令、union 类型错误处理模式等。适用场景为复杂数据关系与多样客户端需求;限制与风险包括:每个解析器单独查询导致 N+1、深层嵌套查询可致 DoS、生产环境内省暴露 schema、仅靠指令鉴权不足、查询级鉴权但缺少字段级鉴权。资料建议限制深度与复杂度、查询超时、按客户端限流、持久化查询、生产环境禁用内省与 Playground,并在解析器及敏感字段上实施鉴权。2025 经验:简单 CRUD 用 REST 更简单,高性能公共 API 用带缓存的 REST 更优。