Go模块路径必须与go.mod中module声明严格一致，如声明example.com/myapp则import必须用example.com/myapp/开头，不可用myapp或相对路径；错误时应删除go.mod和go.sum后重新init。
Go 1.21+ 安装后 go mod init 报错：module declares its path as example.com/myapp but was required as myapp
这是 Go 模块路径不一致导致的典型错误，不是 GraphQL 的问题，但会卡在环境搭建第一步。Go 要求模块导入路径必须与 go.mod 文件中声明的 module 行完全一致，且需能被 Go 工具链解析（通常需含域名或使用 ./ 相对路径）。
- 不要用纯项目名如
myapp作为 module path；改用类似github.com/yourname/myapp或本地开发时用example.com/myapp - 若只是本地实验，推荐直接初始化为
go mod init example.com/myapp，后续所有import都按此路径写 - 如果已出错，删掉
go.mod和go.sum，重新go mod init并确保后续go get引入依赖时路径匹配
选 graphql-go/graphql 还是 99designs/gqlgen？
二者定位不同，选错会导致后续大量返工。
-
graphql-go/graphql是底层解析器实现，提供graphql.Do、graphql.NewSchema等原始 API，适合需要细粒度控制执行逻辑、做定制化 AST 处理或嵌入已有服务的场景 -
gqlgen是代码生成器，基于 schema-first（.graphql文件），自动生成 resolver 接口和绑定代码，适合快速构建标准 CRUD API，但要求严格遵循 schema → code 流程 - 如果你已有 REST 接口想加一层 GraphQL 封装，或要复用现有 struct 方法，
graphql-go/graphql更灵活；如果团队统一用 SDL 定义接口、追求强类型保障，gqlgen更省力 - 注意：
graphql-go/graphql不维护了（最后更新 2021），生产项目建议用gqlgen或更活跃的vektah/gqlparser+graph-gophers/graphql-go
用 graph-gophers/graphql-go 启动服务时，http.HandlerFunc 总返回 405 Method Not Allowed
这个库默认只响应 POST 请求，且要求 Content-Type 为 application/json。直接浏览器 GET 访问 playground 页面会触发 405，不是配置错误，是设计如此。
Golang Uber Dig
下载
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等
- GraphQL 查询必须走
POST /query（或你指定的 endpoint），不能用 GET 带 query 参数（除非显式启用AllowGetRequests） - 启动 server 时，需显式注册 handler：例如
http.Handle("/query", &graphql.Handler{Schema: schema})，别漏掉路径前缀 - 如果要用 GraphiQL 或 Playground，得额外提供静态 HTML 页面（如
http.FileServer），并让前端 JS 发 POST 请求到/query - 常见疏漏：没设置
http.Post允许的 header，比如 CORS 场景下漏了Access-Control-Allow-Headers: content-type
resolver 返回 nil 字段时，GraphQL 响应里出现 "field": null，但期望跳过该字段
GraphQL 规范要求 nullable 字段显式返回 null，但 Go 的 struct 字段零值（如 ""、0、nil）会被序列化成对应 JSON 值，而非省略字段。这不是 bug，是 Go JSON 编码行为与 GraphQL 语义的错位。
立即学习“go语言免费学习笔记（深入）”；
- 对指针字段（
*string、*int），返回nil会正确映射为 GraphQLnull；但非指针字段无法表达“未设置”语义 - 避免用
json:",omitempty"标签——GraphQL 解析器不走标准json.Marshal，该标签无效 - 真正可控的方式是：定义 resolver 函数返回指针类型，或用
graphql.Null（在graph-gophers/graphql-go中）显式表示缺失值 - 如果字段本应必填（non-null），却返回
nil，整个响应会带errors数组，且该字段值为null—— 这是规范强制行为，无法绕过
