Golang构建GraphQL接口实战与语言学习中的现代API演进-Golang-PHP中文网

直接选gqlgen；它在生成阶段就校验schema.graphqls与go struct字段对齐（如id!→string、datetime需显式实现），而graphql-go/graphql依赖运行时反射，字段错位或类型不匹配仅在请求时panic，调试成本高。

golang构建graphql接口实战与语言学习中的现代api演进

选 gqlgen 还是 graphql-go/graphql？

直接选 gqlgen。它在生成阶段就校验 schema.graphqls 和 Go struct 字段是否对齐，比如 ID! 必须对应 string，DateTime scalar 必须有显式实现；而 graphql-go/graphql 依赖运行时反射，字段名拼错、类型不匹配（如把 *int 当 int）、嵌套 slice 深度不一致，全得等请求进来才 panic，典型错误：panic: interface conversion: interface {} is nil, not *model.User。

实际开发中，你改一行 schema 就得重新跑 go run github.com/99designs/gqlgen generate，但换来的是 resolver 函数签名被强制约束——比如 func (r *queryResolver) Users(ctx context.Context, first *int) ([]*model.User, error)，参数是否为指针、返回值顺序、error 位置都不能调换，IDE 能直接跳转、编译期报错，省掉大量 runtime 排查时间。

resolver 里怎么安全传 db 和 context？

别在 resolver 里 new db 连接，也别用全局变量塞 db 或 redis.Client。连接池必须提前建好，通过依赖注入方式传入：

Golang Uber Dig

使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等

下载

Resolver{DB: db, Cache: cache, Logger: log}，然后每个 resolver 方法都从接收者取
每个 resolver 函数签名里的 ctx context.Context 必须透传到底层数据库调用，比如用 pgx/v5 时写 db.QueryRow(ctx, ...)，不能用老版本无 ctx 的 QueryRow()
对慢查询设超时：用 ctx, cancel := context.WithTimeout(r.ctx, 5*time.Second) 包一层，查完立刻调 cancel()，否则一个卡住的 posts 查询会拖垮整个嵌套查询 { users { name posts { title } } }

schema.graphqls 和 Go struct 怎么对齐不翻车？

gqlgen 不自动读 json:"xxx" 标签，也不按首字母大小写隐式转换。字段名、类型、空值语义必须手动对齐：

ID! → Go 中必须是 string（不是 int64），且 resolver 返回前要显式转成 graphql.ID（如果用了自定义 scalar）
DateTime 这类非原生 scalar，必须在 gqlgen.yml 里配置映射，比如 map[string]string{"DateTime": "time.Time"}，并实现 MarshalDateTime/UnmarshalDateTime
struct 字段带 json:"-" 不代表 GraphQL 会忽略它——gqlgen 默认仍生成该字段，得在 schema.graphqls 里删掉，或在 gqlgen.yml 的 models 配置中 fields 显式 omit
嵌套 slice 如 posts: [Post!]!，Go 端必须是 []*model.Post（不是 []model.Post），否则生成代码会报类型不匹配

generated/ 和 model/ 目录冲突怎么解？

gqlgen 默认把生成的 resolver 接口和 model struct 全塞进 graph/model，一执行 generate 就覆盖你加的 JSON tag、自定义方法、字段注释。解决办法只有两个：

把业务模型挪到独立包，比如 pkg/model，然后在 gqlgen.yml 的 models 段指定映射：model.User: pkg/model.User
用 gqlgen 的 autobind 功能绑定已有 struct，而不是让它生成新 struct；同时关掉 generate 对 model 的覆盖行为，在配置里设 model: 下的 filename 为空或指向只读目录