能跑不等于能上线，gqlgen服务上线前最常卡在五个地方：schema改了没执行gqlgen generate、resolver签名与生成接口不匹配、HTTP handler注册错误、context.Context未透传、error未用graphql.Errorf包装。
能跑不等于能上线，gqlgen 服务上线前最常卡在五个地方：schema 改了没 gqlgen generate、resolver 签名和生成接口对不上、HTTP handler 注册错、context.Context 没透传、error 没用 graphql.Errorf 包装。
schema 修改后必须手动运行 gqlgen generate
gqlgen 不监听文件变化，改完 schema.graphql 后不执行生成命令，generated.go 里还是旧接口——编译不报错，但一调 resolver 就 panic："no such method"。
- 每次保存
schema.graphql后，立刻执行：go run github.com/99designs/gqlgen generate - 别依赖
gqlgen serve的自动重载：它只重启 HTTP server，不触发代码生成 - 新增了
Mutation或input类型，检查gqlgen.yml的models段是否已映射对应 Go 结构体，否则生成器跳过整个链路 -
generated.go是只读契约文件，所有业务逻辑只写在resolver.go里
resolver 函数签名必须和 generated 接口完全一致
Go 编译器不校验你实现的 resolver 是否满足 gqlgen 生成的接口，但 runtime 会严格按反射匹配：参数顺序、指针与否、返回值个数，错一个就 panic。
- 根级字段（如
Query.users）签名示例：func (r *queryResolver) Users(ctx context.Context, first *int) ([]*model.User, error)——first *int是指针，不是int；[]*model.User是指针切片，不是[]model.User - 如果 schema 定义的是
User!（非空），返回值类型必须是*model.User，不能是model.User；否则nil值会被当成有效数据返回 - 方法名大小写必须和 schema 字段名完全一致：
userName≠Username - 接收者类型必须是
*queryResolver（指针），不能是queryResolver（值类型）
HTTP handler 注册错，请求直接 404 或 panic
gqlgen 不自带 HTTP server，只提供 http.Handler。漏注册、路径写错、用错方式，都会导致前端发请求却收不到响应。
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等
- 正确注册方式：
http.Handle("/graphql", handler)（注意是Handle，不是HandleFunc） - 别写成
http.HandleFunc("/graphql", handler.ServeHTTP)——handler本身已是http.Handler，不需要再拆 - 用 Gin 时，必须包装：
r.POST("/graphql", gin.WrapH(handler))；只写r.POST("/graphql", handler)会编译失败 - GraphQL 默认只响应 POST 请求；如果 Nginx 或中间件限制了 method，需显式放开 POST 和 GET（GraphiQL 需要 GET）
resolver 里 error 必须用 graphql.Errorf 包装
Go 的 error 类型无法被 GraphQL 自动转为规范的 errors 字段；若 resolver 返回 fmt.Errorf("not found")，客户端只会看到空数据 + 模糊的 200 响应，错误细节全丢。
- 推荐写法：
return nil, graphql.Errorf("user %s not found", id) - 若需携带扩展字段（如
code、timestamp），用graphql.WithExtensions(map[string]interface{}{"code": "USER_NOT_FOUND"}) - 普通 Go 错误（如 DB 查询失败）要显式包装，不能裸
return - resolver 参数里的
context.Context不是摆设：所有下游调用（DB、HTTP）都必须传入该ctx，而非context.Background()
最易被忽略的是：每次改 schema.graphql 后，generated.go 不会自动更新；而 panic 往往发生在运行时，不是编译期——这意味着本地测试可能通过，上线后第一个请求就崩。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
