resolver 返回 nil 是因为 GraphQL-Go 不自动映射 struct 字段，需显式定义 Resolve 函数；字段须首字母大写、非空指针或 interface{}；调试可打印 params.Source 确认数据。
用 graphql-go/graphql 实现基础 schema 时，为什么 resolver 总是返回 nil？
因为 Go 的 GraphQL 库默认不自动映射 struct 字段，必须显式声明 resolver 函数或启用反射规则。常见错误是直接传入 struct 指针却没配 Resolve 字段，导致字段值无法被序列化。
- 确保每个
graphql.Field都有Resolve函数，哪怕只是简单返回params.Source对应字段 - 若用
graphql.Fields自动生成字段，需配合graphql.NewObject的Fields参数 +graphql.FieldConfig显式定义类型和 resolver - struct 字段必须首字母大写（导出），且不能是未初始化的指针或空 interface{}；
nil值在 resolver 中不会报错，但前端收到的是null - 调试技巧：在 resolver 里加
fmt.Printf("source: %+v\n", params.Source)确认上下文数据是否如期传递
处理嵌套查询（比如 User → Posts）时，怎么避免 N+1 查询问题？
GraphQL 天然容易触发 N+1：父 resolver 返回 10 个 User，每个 User 的 posts 字段又单独查一次数据库。Go 里没有像 JavaScript 的 dataloader 那样开箱即用的方案，得自己控制批处理时机。
- 不要在每个
postsresolver 里直接调db.FindPostsByUserID()，而是把所有待查的user_id收集起来，在父级 resolver 结束后统一查一次 - 推荐用
map[int][]*Post缓存结果，key 是user_id，然后在子 resolver 中按需取值 - 注意并发安全：如果 resolver 是并行执行的（默认行为），收集 ID 和填充缓存需加锁，或改用
sync.Map - 更稳妥的做法是用
graphql.WithContext把批处理器注入 context，在 resolver 中通过params.Context.Value()获取并调用LoadPosts([]int{...})
如何让 GraphQL 接口支持 HTTP POST + JSON 而不是只认 GET 查询字符串？
默认 graphql-go/handler 的 graphql.Handler 只解析 URL 查询参数，POST 请求体里的 {"query":"..."} 会被忽略，返回空响应或 400。
- 必须用
graphql-go/handler.New替代graphql-go/handler.GraphQL，并显式设置Playground: true和GraphiQL: true（否则 POST 不生效） - HTTP handler 需要支持
Content-Type: application/json，且手动读取 body：io.ReadAll(r.Body)，再解码到struct{ Query, Variables, OperationName string } - 别漏掉
r.Header.Set("Content-Type", "application/json")，否则某些客户端（如 Apollo）会拒绝发送变量 - 开发阶段建议加日志：
log.Printf("GraphQL query: %s, vars: %+v", req.Query, req.Variables)，方便定位解析失败点
使用 gqlgen 生成代码时，为什么 models_gen.go 里字段类型全是 interface{}？
这是 gqlgen 在找不到对应 Go 类型映射时的兜底行为，通常因为 gqlgen.yml 里没配 models 映射，或 struct 定义不在 models 搜索路径下。
立即学习“go语言免费学习笔记（深入）”；
- 检查
gqlgen.yml是否有models:区块，并确认model字段指向的 Go 类型存在且可导入（比如github.com/you/app/model.User） - struct 必须在
models指定的包里，且字段名与 GraphQL schema 中的字段名**完全一致**（大小写敏感） - 如果用了自定义标量（如
Date），必须在gqlgen.yml的scalar下配置 Go 类型和序列化函数，否则也会退化为interface{} - 运行
go run github.com/99designs/gqlgen generate后，看终端有没有 warning 提示 “no type found for XXX”，那是最直接的线索
