用gqlgen搭建GraphQL服务最省事：先写schema.graphql，运行gqlgen init生成骨架，再用gqlgen generate生成强类型代码，仅在resolver.go中实现匹配签名的业务逻辑，注意HTTP路由正确注册、resolver函数接收ctx且返回值类型与schema严格一致，每次schema变更后必须重新generate。
用 gqlgen 搭建 GraphQL 服务最省事
Go 生态里，gqlgen 是目前最主流、维护最活跃的 GraphQL 服务生成器，它不 runtime 解析 schema，而是通过代码生成（codegen）把 SDL 转成强类型 Go 结构和 resolver 接口，编译期就能发现字段缺失、类型不匹配等问题。
关键不是“能不能”，而是“怎么避免生成后改不动、跑不起来”：
- 必须先写好
schema.graphql，哪怕只有一条type Query { hello: String }，gqlgen init才能生成骨架 -
gqlgen generate每次都会覆盖generated.go，但不会碰你手动写的resolver.go—— 所以 resolver 实现一定要放在单独文件，且函数名要严格匹配生成的接口签名 - 别直接
go run .启动：生成的server/server.go默认用http.DefaultServeMux，而gqlgen的 handler 需要注册到特定路径（如/query），否则返回 404 或空响应
resolver 函数签名不对就会 panic
生成的 resolver 接口形如 func (r *queryResolver) Hello(ctx context.Context) (*string, error)，注意三点：
- 接收者类型必须是
*queryResolver（或你配置的 resolver 前缀），不能是queryResolver（值类型） - 返回值顺序固定：
(T, error)，其中T必须和 schema 里字段类型完全一致（String→*string，[User!]!→[]*User） - 如果字段返回非指针类型（比如
Int!），生成的是int，但 Go 中基本类型不能为 nil，一旦 resolver 返回零值（如 0），GraphQL 会当作有效数据返回，而不是 null —— 这常被误认为“数据没查到”，其实是类型设计问题
HTTP handler 路由配错，请求直接 404
gqlgen 默认不带 HTTP 服务，需要自己套一层。常见错误是：
Golang Uber Dig
下载
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等
- 用
http.HandleFunc("/graphql", handler)，但没调用handler.ServeHTTP—— 正确写法是http.Handle("/graphql", handler)（注意是Handle不是HandleFunc） - 用
gin或echo时，没把gqlgen的http.Handler正确转成对应框架的中间件形式，比如 gin 要用gin.WrapH(handler) - 前端发 POST 到
/graphql，但后端只注册了 GET 路由（gqlgenhandler 默认支持 POST+GET，但如果你手写路由限制了 method 就会失败）
最简验证方式：
curl -X POST http://localhost:8080/graphql \
-H "Content-Type: application/json" \
-d '{"query":"{ hello }"}'
schema 变更后忘记 regenerate，编译就报错
这是新手最高频的卡点：改了 schema.graphql，比如加了个 users 字段，却没运行 gqlgen generate，接着 go build 就会提示 missing method Users 或 cannot use ... as resolver.UserResolver。
- 不要手动补方法签名 —— 生成器会按 schema 重写整个接口，手写会被覆盖
- 如果想保留部分自定义逻辑（比如带参数的查询），在
gqlgen.yml里配置models映射，把 schema 类型指向你已有的 struct，避免生成冗余结构体 - CI 中建议加入
gqlgen generate && git diff --quiet || (echo "schema changed but not regenerated"; exit 1)防止漏提交生成文件
真正麻烦的从来不是“搭起来”，而是 schema 和 Go 类型之间那层映射关系——它不报运行时错，但一动就编译不过，而且错误信息往往指向生成代码里的某一行，容易让人往错方向查。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
