SuperAPI AI 工具集

graphql-apollo-server

通用与其它

查看项目

更新于 10-16 03:43

技能介绍

用途:该技能用于构建生产就绪的 GraphQL API 服务,覆盖从基础服务器搭建到生产环境部署的完整流程。

主要能力:

  1. 核心服务器与 Express 集成:使用 @apollo/server 作为核心包,@apollo/server/express4 提供 Express 中间件集成,示例端口为 4000,路径为 /graphql。
  2. 生产配置:支持 formatError 错误格式化(生产环境隐藏内部错误)、通过 introspection 开关在生产环境禁用内省。
  3. 自定义插件:通过 @apollo/server/plugin/* 实现扩展,示例包含日志插件(记录操作名与耗时)和查询复杂度插件(使用 graphql-query-complexity 的 simpleEstimator,超过 1000 抛错)。
  4. 联邦子图:使用 @apollo/subgraph 的 buildSubgraphSchema,结合 @link 指令声明 federation v2.0,并用 @key 定义实体解析。
  5. 响应缓存:@apollo/server-plugin-response-cache 配合 @cacheControl 指令控制缓存策略(如 maxAge 3600 或 PRIVATE)。
  6. 健康检查:提供 /health 与 /ready 端点,返回 200 或 503。

使用方式:通过 Skill("graphql-apollo-server") 调用;调试可用 curl 访问 /health、以 POST 请求 /graphql 并发送 query 验证。

适用场景:需要搭建生产级 GraphQL 服务、微服务联邦架构或带缓存与健康检查的 API 网关的场景。

限制与注意事项:需避免全局数据加载器造成内存泄漏,应每请求创建;CORS 中间件需在 expressMiddleware 之前注册;平滑关闭需 DrainHttpServer 插件,否则关闭时可能返回 503;大型 schema 可考虑 schema 缓存以加快启动。资料未提供定价、平台限制或其他收费信息。