用途:在 Golang 中实现 GraphQL API,适用于构建 GraphQL 服务器、设计 schema、编写 resolver 与审查现有 GraphQL 代码。两种主要库均为 schema-first:编写 SDL(.graphql 文件)并绑定 Go resolver。gqlgen 基于代码生成、编译期类型安全、需要 go generate,适合大型 schema、联邦与严格类型;graph-gophers/graphql-go 基于反射、解析期检查、无需构建步骤,适合中小 schema 与快速迭代。主要能力与要点:schema 设计上明确可空性(仅在服务端总能返回时标记 !)、用 ID 标量表示不透明标识、列表使用 Relay 游标分页、变更结果用 envelope 类型承载业务错误;resolver 保持轻薄、委托服务层、按类型拆分 resolver 结构体。用 DataLoader 合并按字段加载以避免 N+1,且必须在 HTTP 中间件中按请求创建,绝不能全局共享,否则会有陈旧数据与跨用户泄露。认证授权分两层:HTTP 中间件校验令牌并写入 context,gqlgen 用 @hasRole 等 schema 指令做字段级授权,graphql-go 在 resolver 中检查。错误处理不得返回原始内部错误,gqlgen 用 SetErrorPresenter 与 gqlerror 扩展码,graph-gophers 实现 ResolverError 接口;gqlgen 可用 graphql.AddError 返回非致命字段错误。订阅使用 WebSocket,必须在客户端断开时通过 ctx.Done 与 defer close(ch) 避免 goroutine 泄漏。性能安全:生产环境需显式限制,如 gqlgen 的 extension.FixedComplexityLimit(200),graphql-go 的 graphql.MaxDepth 与 graphql.MaxParallelism;仅非生产环境启用 introspection,可考虑持久化查询。常见错误包括子 resolver N+1、全局 DataLoader、直接编辑 models_gen.go、schema 变更后忘记运行 go tool gqlgen generate、graph-gophers 的 Int 需用 int32、生产开启 introspection、无复杂度上限、泄露数据库错误、订阅 goroutine 泄漏与可空字段误用。该技能并非详尽文档,API 签名请参考各库官方文档;Go 包信息可参考相关技能,缺失信息暂未提供。
golang-graphql
编程与开发
更新于 10-16 09:55