Mock 与测试策略
GraphQL Mock 与测试策略实战：@graphql-tools/mock 的 addMocksToSchema、MockList、faker 集成与确定性种子、Schema 快照与 mock 驱动的前端开发、resolver 单元测试、executeOperation 集成测试、MSW 客户端拦截、联邦子图 mock、测试数据管理与 CI 分层。
category
API 工程
共 19 篇文章。
标量类型与输入校验
GraphQL 标量类型与输入校验实战：自定义标量的 serialize/parseValue/parseLiteral 三件套、graphql-scalars 常用标量、ID 与 DateTime/Decimal 的坑、标量 vs 指令 vs resolver 的校验分层、Zod 集成、codegen 映射、错误归一化与测试方法。
自定义指令与模式扩展
GraphQL 自定义指令与 Schema 扩展实战：区分可执行指令与类型系统指令，讲解 @auth/@hasRole 字段级鉴权、@upper/@constraint 变换、mapSchema 与 MapperKind 实现、指令参数校验、Federation 指令协同、性能陷阱与测试策略，并给出指令设计的取舍准则。
压测与容量规划
GraphQL 压测与容量规划实战：从 REST 压测的差异出发，讲解 k6/Artillery/autocannon 脚本编写、查询组合与权重建模、延迟分位与饱和度指标、连接池与 DataLoader 瓶颈定位、容量估算公式、冒烟/负载/压力/浸泡/尖峰五类测试，以及接入 CI 的回归门禁。
Serverless 与边缘部署
GraphQL 在 Serverless 与边缘运行时的部署实战：冷启动治理、连接复用、DataLoader 跨实例失效、边缘运行时约束、APQ 与 KV 持久化、流式响应、可观测性与成本模型，给出 Lambda、Cloudflare Workers、边缘函数三种形态的落地要点与取舍。
Schema Stitching 与服务聚合
Schema Stitching 与服务聚合实战：对比 stitching 与 Federation 的取舍，讲解 @graphql-tools/stitch 的类型合并、@merge 与 computed fields、delegateToSchema 委派、Schema 变换、批量查询、错误传播、缓存与订阅、性能调优，以及聚合网关的落地与迁移路径。
GraphQL 限流与成本控制：查询成本分析、复杂度限制与按量计费
GraphQL 限流与成本控制深度：查询成本分析（Query Cost Analysis）、深度/宽度/别名限制、速率限制策略、按量计费模型与成本治理，帮助团队在开放 GraphQL API 的同时守住可用性与账单。
GraphQL 请求批处理与增量交付：@defer、@stream 与 Batching
GraphQL 请求批处理与增量交付深度：HTTP 批处理、@defer/@stream 指令、增量加载与 Suspense 集成、实现方案与性能收益，帮助客户端减少首屏等待与网络往返。
GraphQL Mutation 设计实战：从语义命名到乐观更新
GraphQL Mutation 设计实战：命名与语义、输入输出对象设计、乐观更新（optimistic UI）、multipart 文件上传、幂等与 clientMutationId、乐观锁冲突检测、变更订阅联动（pub/sub）与 REST 迁移。
游标分页与中继连接：从 offset 到 cursor 的工程实践
GraphQL 游标分页与 Relay Connection 实战：offset vs cursor 分页、edges/node/pageInfo 连接规范、游标编码、排序稳定性与过滤、totalCount 获取策略、无限滚动、分页缓存配合与常见坑。
GraphQL Schema 设计进阶：接口、联合类型与可空性策略
GraphQL Schema 设计进阶实践：interface/union 抽象建模、input/oneOf 输入对象设计、命名与弃用策略、Relay 连接规范、null vs error 可空性策略、SDL 模块化组织与 codegen 类型安全生成。
tRPC 端到端类型安全 API：从路由定义到 Next.js 全栈集成
tRPC 深度实战：procedure/router/middleware 核心概念、Zod 输入校验、React Query 集成、订阅支持、Next.js App Router 适配、与 GraphQL/REST 的混合策略。
GraphQL 与现代 API 工程
GraphQL 作为一种革新性的 API 查询语言，解决了 REST 接口过度获取与多次请求的核心痛点。本专题从 Schema 设计与类型系统出发，深入讲解服务端实现方案（Apollo Server/Yoga/Pothos）、客户端状态管理（Apollo Client/Relay/urql）、GraphQL 网关与联邦架构（Apollo Federation）、订阅与实时数据推送、性能优化（DataLoader 批处理/缓存/查询复杂度限制）、与 tRPC/REST/gRPC 的对比选型，以及在现代微服务架构中的落地实践，为 API 工程师提供从单体 GraphQL 服务到分布式联邦架构的完整工程指南。进阶篇进一步覆盖 Schema 深化（interface/union/input 对象/Relay 连接规范）、Resolver 性能与 N+1 优化（DataLoader/Redis 缓存）、错误处理与可观测性（errors[]/extensions.code/链路追踪）、游标分页与中继连接、持久化查询（APQ/白名单/CSRF 防护）、Mutation 设计实战（幂等/乐观更新/文件上传）、认证与授权深度（JWT/RBAC/ABAC/字段级权限）、工具链与代码生成（codegen/Schema Registry）、文件上传与流式传输（multipart/分片/预签名直传/@defer/@stream）、可观测性与链路追踪（OpenTelemetry/resolver 指标/N+1 观测）、多态类型设计（interface/union/__typename/inline fragment）以及过滤搜索与聚合（FilterInput/游标分页/全文搜索/faceted 聚合），再进一步覆盖 Schema 治理与 Registry（破坏性变更检测/CI 门禁/弃用流程）、代码生成与端到端类型安全（graphql-codegen/typed document node）、联邦 Router 运维与查询计划调优、数据库与 ORM 集成（Prisma/Drizzle/事务/连接池）、REST 到 GraphQL 的渐进迁移（绞杀者模式/双栈并存）以及事件驱动与 Webhook 集成（事件 Schema/投递保证/幂等/死信），构成从入门到生产强化的完整 API 工程体系。并补齐 Schema Stitching 服务聚合、Serverless 与边缘部署、压测与容量规划、自定义指令与模式扩展、标量类型与输入校验、Mock 与测试策略等进阶议题。
GraphQL vs REST vs gRPC vs tRPC：API 范式深度对比与选型
四种主流 API 技术范式 16 维度全面横评：传输协议、序列化、流式支持、类型安全、适用场景与决策矩阵，附带实战选型流程图。
GraphQL Schema 演进与版本控制：零破化变更策略
GraphQL Schema 变更分类：安全/危险/破坏性变更识别、@deprecated 策略、Schema Registry 版本管理、CI 自动化校验，实现 API 平滑演进。
API 网关实战：Kong、Envoy 与 Traefik 选型与部署
主流 API 网关深度对比：Kong（OpenResty + Lua 插件）、Envoy（Envoy Proxy + xDS 动态配置）、Traefik（云原生自动发现）。含路由、限流、认证、可观测性完整配置。
API 缓存与性能优化：CDN、查询复杂度分析与持久化查询
现代 API 性能优化全链路：HTTP 缓存策略、GraphQL CDN 边缘缓存、查询复杂度计算与限流、持久化查询（Persisted Queries）、DataLoader 缓存、响应压缩与 HTTP/2 多路复用。
API 架构演进路线：从单体 REST 到联邦 GraphQL 的决策框架
API 架构演进方法论：单体 REST → BFF → GraphQL 聚合 → 联邦架构的完整路径。技术选型框架、团队能力模型、迁移策略与投资回报评估矩阵。
API 契约测试：Schema 校验、Pact 与 CI 流水线集成
API 契约测试方法论：Schema 校验、消费者驱动（CDC）与提供者验证、Pact 契约测试框架、Postman/Bruno 集成测试、MSW Mock 服务、Playwright E2E 与 CI 流水线完整实战。