gqlgen init 生成的代码无法运行是因为只创建骨架而未实现 resolver 接口，需手动补全 graph/resolver.go 中所有 resolver 方法，尤其是 Mutation 和自定义类型字段，并在修改 schema 或配置后执行 gqlgen generate。
gqlgen init 生成的代码为什么跑不起来？
因为 gqlgen init 只生成骨架，没补全 resolver.go 中的接口实现，Go 编译会直接报错：类型不满足 graphql.Resolver 接口。常见错误现象是 cannot use &Resolver{} (type *Resolver) as type graphql.Resolver。
- 检查
graph/resolver.go里每个 resolver 方法是否都实现了，尤其Mutation和自定义类型字段（比如User.ID） -
gqlgen generate必须在修改schema.graphql或gqlgen.yml后手动执行，它不会自动监听文件变化 - 如果用了
map[string]interface{}或指针嵌套结构，gqlgen无法自动生成绑定，得手写Marshal/Unmarshal方法
resolver 函数参数里的 *model.User 和 *graphql.ResolveParams 有什么区别？
前者是 gqlgen 根据 models_gen.go 生成的 Go 结构体，对应 GraphQL schema 中的 type User；后者是旧版 gqlgen（v0.13 之前）用的上下文包装，新版已弃用 —— 现在 resolver 签名应为 func(r *queryResolver) User(ctx context.Context, obj *model.User, id string) (*model.User, error)。
- 参数顺序固定：
ctx总是第一个，obj（父对象）第二个，之后才是 query/mutation 的输入参数 - 如果 resolver 是根级（如
Query.users），obj是nil，别对它解引用 - 返回值必须严格匹配 schema 定义的类型，比如 schema 写的是
User!（非空），就不能返回(*model.User, nil)且*model.User == nil
如何让 gqlgen 支持数据库查询（比如 GORM）并避免 N+1？
gqlgen 默认按字段逐个调用 resolver，不做批处理，直接连 GORM 会触发 N+1 查询。关键不是换 ORM，而是用 dataloader 模式把多个 ID 合并成一次 SQL。
- 在
server.go初始化时，用dataloaden生成 loader（需先写loader.go描述 batch 函数） - resolver 中通过
ctx.Value(loaderCtxKey)拿到 loader 实例，再调LoadUser(ctx, id)，而不是直连 DB - 注意 loader 的生命周期：它应该绑定到单个 GraphQL 请求的
context.Context，不能复用跨请求 - 如果字段返回切片（如
[Post!]），loader 的 batch 函数必须能处理[]string并返回[]*model.Post，顺序和输入一致
gqlgen serve 本地调试时，怎么改 schema 就实时生效？
默认 gqlgen serve 不监听文件变化，改了 schema.graphql 必须手动 Ctrl+C 再重跑。真正省事的方式是用 air 或 reflex 配合 gqlgen generate 自动触发。
立即学习“go语言免费学习笔记（深入）”；
- 装
air：go install github.com/cosmtrek/air@latest - 在项目根目录加
.air.toml，重点配build.cmd = "go run github.com/99designs/gqlgen generate && go build -o ./app ." - 监听范围设窄点：
watch = ["schema.graphql", "gqlgen.yml", "graph/*.go"]，避免每次保存都全量重编 - 浏览器访问
http://localhost:8080/进 GraphQL Playground，但注意：Playground 不缓存 schema，每次刷新都会重新 fetch，所以改完等 air 重建完成再刷新
最常被忽略的一点：gqlgen 对 schema 中的 directive（比如 @auth）默认不处理，要支持就得自己写 Config.Directives 注册函数，否则 schema 虽然能编译过，运行时 directive 会被静默忽略。
