直接用Echo+gqlgen可行，但必须绕过Echo默认JSON解析逻辑，否则POST/graphql收不到query字段；关键在避免中间件提前读取Body、正确包裹gqlgen handler并传递原生context。
直接用 Echo + gqlgen 是可行的，但必须绕过 Echo 默认的 JSON 解析逻辑，否则 POST /graphql 会收不到 query 字段——这是最常卡住的点。
为什么 Echo 默认 POST 处理器不兼容 GraphQL
Echo 的 c.Request().Body 在中间件或 handler 中只能读一次；GraphQL 请求体是 {"query":"...", "variables":{}}，而 Echo 的 c.Bind() 或 c.BodyBytes() 若提前触发（比如被日志中间件、JWT 解析器调用），后续 gqlgen 就会读到空 body，返回空响应或 "must provide query string" 错误。
- 别在 GraphQL handler 前加任何读取 Body 的中间件（包括
echo.MiddlewareFunc里调io.ReadAll） - 不要用
c.Bind(&req)手动解析请求体——gqlgen内部已做，重复解析会导致 body 耗尽 - 确保路由注册顺序：GraphQL handler 必须是独立路径（如
/query），不能和 REST 路由共用同一组中间件
如何正确注册 gqlgen handler 到 Echo
核心是把 gqlgen 的 http.Handler 包裹进 Echo 的 echo.HTTPHandler，并禁用 Echo 自动解析 Body：
- 注册时用
e.POST("/query", echo.WrapHandler(server))，其中server是handler.NewDefaultServer(...)实例 - 务必在
WrapHandler前关闭 Echo 的自动绑定：e.Use(func(next echo.HandlerFunc) echo.HandlerFunc { return next })不起作用，真正有效的是避免任何中间件碰Body - Playground 需单独注册：
e.GET("/playground", echo.WrapHandler(playground.Handler("GraphQL playground", "/query")))，路径必须和 POST 路径一致 - 如果需要鉴权，把 token 解析逻辑写在
server初始化前，通过handler.Server.SetRequestContext注入到context.Context，而不是在 Echo 中间件里读 Body
resolver 里怎么拿到 Echo 的 context 和依赖
gqlgen 的 resolver 签名固定为 func(ctx context.Context, args) (T, error)，Echo 的 echo.Context 不能直接传进去——它不是标准 context.Context。正确做法是提取底层 context.Context：
立即学习“go语言免费学习笔记（深入）”；
- 在 Echo handler 中，用
c.Request().Context()获取原生context.Context，再注入 DB、logger 等依赖：ctx = context.WithValue(c.Request().Context(), "db", db) - 把该
ctx传给server.ServeHTTP（需自定义 handler）或通过server.SetRequestContext设置钩子函数 - resolver 函数内用
ctx.Value("db")取依赖，**别存为Resolver结构体字段**——每次请求都是新ctx，存了也取不到 - 若用
dig管理依赖，resolver 构造函数里只接收*dig.Container，在方法体内用c.Invoke(...)按需提取，避免生命周期错乱
常见错误：返回空数据却没报错
前端看到 {"data":{"users":null}}，但后端日志无异常，大概率是 resolver 返回了 nil, nil 而非 nil, err：
- 数据库查不到数据时，别写
return nil, nil，应返回return nil, gqlerror.Errorf("user not found") - GORM 查询用
db.WithContext(ctx).Find(&users).Error判断失败，而不是靠len(users) == 0 - 嵌套字段（如
User.Posts）的 resolver 若未实现，gqlgen默认返回null，不会 panic——检查graph/generated/generated.go是否生成了对应接口方法 - 字段名大小写不匹配：Go struct 字段必须首字母大写，且与 schema 中字段名严格一致（
CreatedAt↔created_at不行，得用json:"createdAt"或gqlgen.yml映射）
真正麻烦的不是配置，而是 body 读取时机和 context 传递路径——这两处一旦错位，问题现象完全不报错，只静默丢数据。
