gqlgen 报错“cannot find package”或“no go files”根本原因是模块路径与文件结构不一致；需确保 go.mod 路径、import 路径、gqlgen.yml 中 models 和 schema 路径严格匹配，且对应 go 包存在有效 .go 文件。
gqlgen 生成代码时报错：“cannot find package” 或 “no Go files in …”
根本原因不是 gqlgen 本身出问题，而是它依赖 Go 的模块路径和文件结构严格对齐。你执行 go run github.com/99designs/gqlgen generate 时，它会从 schema.graphql 解析类型，再按 gqlgen.yml 中的 model 和 resolver 配置去扫描对应 Go 包——如果那些包里没有 .go 文件，或 go.mod 路径与实际 import 路径不一致，就直接报这个错。
- 确保项目根目录有
go.mod，且module声明的路径（如example.com/api）和你在 resolver 函数签名里写的 import 路径完全一致 -
gqlgen.yml中的models配置必须映射到真实存在的 Go 类型，比如把 GraphQL 的User映射到model.User，那你就得先有model/user.go，且里面定义了type User struct - 别把
schema.graphql放在子目录里却不更新gqlgen.yml的schema字段路径——默认只认根目录下的schema.graphql
resolver 函数签名总被 gqlgen 覆盖或报错 mismatch
gqlgen 不是“帮你写逻辑”，而是“校验你写的函数是否满足接口契约”。它根据 schema 自动生成 generated.go 里的 resolver 接口，你实现的 resolver 必须和这个接口一模一样：参数顺序、类型、返回值个数、error 是否在最后——差一个 *string 和 string 都会失败。
- 每次改完
schema.graphql后，先运行go run github.com/99designs/gqlgen generate，再检查generated.go里对应方法的签名，照着改你的 resolver 实现 - resolver 方法名必须首字母大写，且和 schema 里字段名完全一致（大小写敏感），比如 schema 写的是
userName，你就不能实现Username或UserName - 别手动改
generated.go——它会被下次 generate 覆盖；所有自定义逻辑只写在resolver.go或其他你指定的文件里
如何让 gqlgen 正确处理嵌套对象、切片、指针和自定义标量
GraphQL 的类型系统比 Go 更灵活，gqlgen 默认只认基础映射（String→string，ID→string），遇到 [User!]、User!、DateTime 这类就得显式配置，否则生成的代码要么编译不过，要么 runtime panic。
- 切片必须用 Go 切片语法：
[User!]对应[]*model.User（注意是指针切片，因为 gqlgen 默认生成非空元素的指针） - 非空对象
User!要映射为*model.User，而不是model.User；空对象User才能映射为model.User - 自定义标量（如
DateTime）需在gqlgen.yml的scalar下配置，例如：DateTime: time.Time，同时在 resolver 初始化时注册序列化函数：runtime.RegisterUnmarshalGQL("DateTime", unmarshalDateTime)
启动服务后 query 返回空对象或 panic：context deadline exceeded
这不是 GraphQL 层的问题，而是 resolver 里调用了阻塞操作（比如没加 context 控制的 HTTP 请求、数据库查询），或者忘记把 context.Context 传下去。gqlgen 默认给每个 resolver 方法注入 ctx context.Context 参数，但如果你在内部新开 goroutine 或调第三方库时不透传，超时就立刻炸。
立即学习“go语言免费学习笔记（深入）”；
- 所有外部调用（DB、HTTP、cache）都必须接收并使用传入的
ctx，比如db.QueryRowContext(ctx, ...)，而不是db.QueryRow(...) - 避免在 resolver 里做同步 sleep、for 循环重试之类的事；真要等，用
select { case - 检查
http.HandlerFunc启动时是否设置了合理的超时，比如用http.TimeoutHandler，否则默认无 timeout，容易卡死连接
最常被忽略的一点：gqlgen 的 Resolver 接口方法签名是生成出来的，但它的 context.Context 参数位置是固定的——永远是第一个。哪怕你只想要一个 string 参数，也得写成 func(r *queryResolver) Name(ctx context.Context, obj *model.User) (string, error)，少一个 ctx 就编译失败，而且错误提示非常不直观。
