核心功能
本 Skill 是一套面向 GraphQL 服务端与客户端的全栈开发指南，覆盖从 Schema 设计到生产部署的完整生命周期。核心能力包括：
- Schema 工程化：强制非空显式标记（
String!）、输入输出分离、Connection 分页规范 - N+1 防护体系：DataLoader 批处理 + 每请求隔离，阻断嵌套查询的性能灾难
- 安全加固：查询深度限制、复杂度评分、内省禁用、超时熔断、持久化查询白名单
- 性能优化：@defer 流式响应、字段级权限校验、Redis Pub/Sub 订阅扩容
- 客户端策略：规范化缓存、乐观更新、错误分级处理
显著优势
1. 生产级安全设计：将查询复杂度转化为可量化的 Rate Limit 指标，区别于传统请求数限流
2. 性能陷阱显性化：明确标记 N+1 为 Critical 级别，提供 DataLoader 标准实现路径
3. 错误处理精细化：支持部分成功（partial success）模式，错误带路径追踪，便于调试
4. 扩展性考虑：订阅（Subscription）章节包含多服务器广播方案，覆盖分布式场景
局限性与风险
- 实现依赖度高：DataLoader、持久化查询等需自行集成，无自动注入机制
- 协议版本敏感：
graphql-ws与旧版subscriptions-transport-ws不兼容，易踩坑 - 复杂度评分主观：字段权重需业务自定义，无通用算法
- Relay 风格绑定：分页规范偏向 Facebook Relay，与简单 offset 需求存在摩擦
适用人群
- 后端工程师：构建 BFF（Backend for Frontend）层或聚合服务
- 全栈开发者：需要统一前后端数据契约的团队
- 架构师：评估 GraphQL 替代 REST 的可行性
常规风险
- DoS 攻击面：未配置深度/复杂度限制时，单条查询可导致数据库过载
- 信息泄露：生产环境未禁用内省会暴露完整 Schema，降低攻击成本
- 缓存穿透：DataLoader 跨请求误用可能导致敏感数据串号
- 订阅资源泄漏：WebSocket 连接未正确清理可能引发内存溢出