直接选 gqlgen。它生成类型安全的 go 代码，避免手写解析逻辑错误；graphql-go/graphql 依赖运行时反射，字段拼错或类型不匹配只能运行时报错，调试成本高。
用 graphql-go/graphql 还是 99designs/gqlgen？
直接选 gqlgen。它生成类型安全的 Go 代码，避免手写解析逻辑出错；graphql-go/graphql 是纯运行时反射方案，字段拼错、参数类型不匹配全靠运行时报错，调试成本高。
常见错误现象：panic: interface conversion: interface {} is nil, not *model.User —— 手动映射 resolver 返回值时类型没对齐，而 gqlgen 在生成阶段就校验结构体字段与 schema 是否一致。
-
gqlgen要求你先写schema.graphql，再运行go run github.com/99designs/gqlgen generate - resolver 函数签名由生成器强制约束，比如
func (r *queryResolver) Users(ctx context.Context, first *int) ([]*model.User, error)，first参数是否为指针、返回值顺序、error 位置都不能调换 - 不支持动态 schema 修改：改了
.graphql文件必须重新生成，不能像graphql-go那样边写边跑
resolver 中怎么处理数据库查询和 context 超时？
别在 resolver 里直接调 db.QueryRow。每个 resolver 函数都接收 context.Context，必须把 ctx 透传给数据库操作，并设好超时。
使用场景：前端发来一个嵌套查询，比如 { users { name posts { title } } }，如果 posts resolver 没带 ctx 或没设 timeout，一个慢查询会卡住整个请求链路。
立即学习“go语言免费学习笔记（深入）”；
- 用
ctx, cancel := context.WithTimeout(r.ctx, 5*time.Second)包一层，查完立刻cancel() - 数据库驱动要支持 context，比如
pgx/v5的QueryRow(ctx, ...)，别用老版本QueryRow(...) - 避免在 resolver 里初始化新 db 连接——连接池应提前建好，作为 resolver 依赖注入（例如通过
Resolver{DB: db}）
gqlgen 的 models 和 generated 目录为什么总冲突？
因为 gqlgen 默认把生成的代码和你手写的 model 放一起，一生成就覆盖掉自定义方法或 JSON 标签。
解决办法是拆开：让 gqlgen 只生成 resolver 接口和执行器代码，把业务 model 独立出来。
- 在
gqlgen.yml中配置models:映射，例如：models: User: model: github.com/your/app/model.User -
model.User自己定义json:"name"、gorm:"column:user_name"等标签，gqlgen不碰它 - 生成器只负责把 schema 字段名翻译成调用
model.User.Name这样的 getter，不生成 struct
如何加 GraphQL Playground 但不让生产环境暴露？
Playground 是开发利器，但 gqlgen 默认不带 HTTP handler，得自己接；线上开着等于把 schema 和调试入口白送出去。
性能影响不大，但兼容性要注意：Playground 依赖 GET /query 响应 HTML，而你的主 GraphQL endpoint 通常是 POST /query。
- 本地开发用
handler.Playground("GraphQL", "/query")，只注册在 dev router 下 - 生产环境彻底删掉这行，或用
if os.Getenv("ENV") == "dev" { ... }包住 - 别用
net/http/pprof那种“加个开关”的方式——开关漏开就是风险，删掉最稳
真正麻烦的是嵌套 resolver 的错误传播：父级 resolver 返回 error，子级 resolver 仍可能被执行。这点文档很少提，得靠日志和 context.Done() 主动退出来兜底。
