用途：帮助团队把现有 REST API 渐进式迁移到 GraphQL，同时不破坏已有客户端。核心思路是先包装、再逐步替换，而非一次性重写。
主要能力：分析并记录现有 REST 端点；设计 GraphQL schema 并把 REST 响应映射为类型；用 Apollo RESTDataSource 包装现有端点；实现 resolver 连接 REST 后端；按端点逐个迁移；最后逐步弃用 REST。资料给出三种策略：Wrapper（快速起步、不改后端、复杂度低）、Gradual（大型 API 与生产系统、复杂度中）、Rewrite（全新机会、复杂度高）。
使用方式：定义继承 RESTDataSource 的数据源类，设置 baseURL，在 willSendRequest 中注入 Authorization 等请求头，并封装 get/post/patch/delete 方法；编写 transform 函数把 REST 字段（如 user_name、created_at）转换为 GraphQL 风格字段（如 username、createdAt）；在 schema 中把 GET 映射为 Query、POST/PATCH/DELETE 映射为 Mutation，嵌套资源映射为对象字段；在 resolver 中调用 dataSources。可用 DataLoader 批量加载防止 N+1，用 cacheOptions（如 ttl: 3600）做缓存并在变更时失效。迁移分三阶段：包装层、关键路径直连数据库并保留 REST 回退、全量迁移并弃用 REST。可用 @graphql-tools/stitch 的 stitchSchemas 拼接多个 REST 服务 schema，用 @deprecated 标注旧字段。错误处理把 REST 状态码映射为 GraphQLError 及 BAD_USER_INPUT、UNAUTHENTICATED、FORBIDDEN、NOT_FOUND、CONFLICT 等扩展码。
适用场景：已有 REST 后端、希望引入 GraphQL 网关或统一多个 REST 服务的项目。
限制：资料未提供具体安装命令、依赖版本、收费与平台信息；示例基于 Apollo Server 与 @apollo/datasource-rest，实际落地需自行确认版本兼容性。