gqlgen init 卡住或报错主因是网络导致 go install 超时及模块校验失败，且要求项目已初始化为 Go module；应先设 GO111MODULE=on，再用 go install 指定稳定版本，必要时删 go.sum 重试。
gqlgen init 命令为什么卡住或报错？
因为 gqlgen init 默认会尝试拉取最新版 gqlgen CLI（通过 go install），而国内网络常导致超时或模块校验失败。它还会自动生成 schema、resolver 模板和 gqlgen.yml，但前提是项目已初始化为 Go module 且 go.mod 可写。
- 执行前先确认：当前目录下有
go.mod，且GO111MODULE=on（推荐设为环境变量） - 避免直接跑
gqlgen init：改用go install github.com/99designs/gqlgen@v0.17.48（选稳定小版本，别用latest） - 如果提示
cannot find package "github.com/vektah/gqlparser/v2"，说明依赖版本冲突，删掉go.sum重试，或手动go get github.com/99designs/gqlgen@v0.17.48
schema.graphql 和 gqlgen.yml 怎么配才不崩？
schema.graphql 是唯一数据源，gqlgen.yml 只是告诉生成器“怎么把 schema 映射到 Go 类型”。常见崩点是 resolver 返回类型和 schema 字段类型对不上，或 models 配置漏了嵌套字段。
-
schema.graphql中每个type的字段名必须和 Go struct 字段名一致（或靠model映射），大小写敏感 -
gqlgen.yml的models区块里，map键是 GraphQL 类型（如User），值是 Go 全路径（如github.com/your/app/graph/model.User） - 如果用了
interface或union，必须在gqlgen.yml中显式配置interfaces和union映射，否则生成器静默跳过 - 别把
gqlgen.yml放错位置——必须和go.mod同级，否则gqlgen generate找不到配置
resolver 方法签名写错会导致编译失败吗？
不会立刻编译失败，但运行时 panic 或 GraphQL 请求返回空对象。因为 gqlgen generate 生成的 resolver 接口只检查方法名和参数数量，不校验具体类型是否可赋值。
- resolver 函数第一个参数必须是
context.Context，第二个是*model.Args（如有参数），返回值顺序：结果、error - 返回值类型必须和 schema 中字段类型完全匹配：比如 schema 写
posts: [Post!]!，Go 里就得返回[]*model.Post，不能是[]model.Post或*[]model.Post - 如果 resolver 返回
nil，且字段非 nullable（没加!），GraphQL 层会自动忽略该字段，不是报错——容易误以为逻辑没走 - 别在 resolver 里直接调
db.Find()返回指针切片却声明为值切片，Go 类型系统拦不住，但 runtime 会 panic
go run ./server.go 报 “no resolver for field Query.users” 怎么办？
说明生成器没找到对应 resolver 实现，或者实现函数名/包路径和生成代码不一致。最常见原因是：你手写了 resolver，但函数名拼错了，或没放在 graph/resolver.go（或 gqlgen.yml 指定的 resolver 路径）里。
- 检查
graph/generated/generated.go里生成的QueryResolver接口定义，对照你的实现——函数名必须严格匹配（如Users，不是GetUsers或users） - 确保你的 resolver 实现结构体实现了整个接口，且被注册进
Config.Resolvers（通常在server.go的handler := handler.GraphQL(...)前） - 如果用了多 package 结构（比如 resolver 分散在
user/resolver.go和post/resolver.go），必须在gqlgen.yml中用resolver指向统一入口文件，或手动合并实现 - 生成后记得
go mod tidy，有时缺失github.com/99designs/gqlgen/graphql导致 resolver 接口无法满足
! 却忘了改 Go 返回类型，直到前端突然收不到数据才意识到。 
