Iris框架集成GraphQL需通过iris.Adapt桥接gqlgen的http.Handler，避免绕过Iris上下文与中间件；resolver中应提前注入认证信息并使用DataLoader防N+1查询，而非重复解析token或逐条查库。
Iris 框架本身不内置 GraphQL 支持，但可以干净地集成 graphql-go/graphql 或更现代的 99designs/gqlgen（Go 生态主流方案）。关键不在“能不能接”，而在于 resolver 层怎么避免 N+1、schema 怎么与 Iris 的路由和中间件协同——否则请求进来了，CPU 打满，数据库连爆，前端看着响应快，后端早崩了。
为什么不用 iris.HandlerFunc 直接挂 GraphQL handler？
直接用 iris.Post("/graphql", graphqlHandler) 看似简单，但会绕过 Iris 的核心能力：
- 丢失
iris.Context中已解析的 JWT token、request ID、trace ID 等上下文信息，resolver 里再手动从 header 解析，重复且易错 - 无法复用 Iris 的 CORS、body limit、gzip 压缩等中间件，得在 GraphQL handler 内自己处理
-
gqlgen默认用http.Handler，而 Iris 的Context不是标准http.ResponseWriter+*http.Request组合，强转容易 panic
用 gqlgen + iris.Adapt() 封装标准 http.Handler
gqlgen 生成的服务是标准 http.Handler，Iris 提供了 iris.Adapt() 工具函数，能安全桥接。这是目前最稳的集成路径：
import (
"github.com/99designs/gqlgen/graphql/handler"
"github.com/kataras/iris/v12"
)
<p>func setupGraphQL(app *iris.Application) {
// 初始化 gqlgen server（假设已生成 gqlgen.yml 和 graph/generated/generated.go）
srv := handler.NewDefaultServer(generated.NewExecutableSchema(generated.Config{Resolvers: &graph.Resolver{}}))</p><p>// 关键：用 iris.Adapt 包装，让 http.Handler 能接入 Iris 流程
app.Any("/graphql", iris.Adapt(srv.ServeHTTP))</p><p>// 可选：GraphiQL 页面（开发用）
app.Get("/graphql/playground", func(ctx iris.Context) {
ctx.Header("Content-Type", "text/html")
ctx.WriteString(graphqlPlayground)
})
}</p>
注意：srv.ServeHTTP 是 func(http.ResponseWriter, *http.Request) 类型，iris.Adapt 正是为此设计，不是黑盒转换。
resolver 中如何拿到 iris.Context 和用户身份？
gqlgen resolver 函数签名是 func(ctx context.Context, obj interface{}, input XXX) (ret interface{}, err error)。Iris 的 Context 不能直接塞进去，但你可以：
- 在
iris.Adapt包装前，把iris.Context注入到http.Request.Context()里，例如：r = r.WithContext(context.WithValue(r.Context(), "iris-context", ctx)) - 然后在 resolver 中用
ctx.Value("iris-context")取出，类型断言为iris.Context - 更推荐：把认证信息（如 user ID、role）提前解出来，存进
context.WithValue(r.Context(), "user_id", uid)，resolver 直接读，不依赖 Iris 实例
别在 resolver 里调 ctx.User() 或 ctx.GetHeader("Authorization") —— 那意味着每次字段解析都重新 parse token，性能灾难。
resolver 里查数据库必须防 N+1
这是 GraphQL 在 Iris（或任何 Go 框架）里最容易翻车的地方。比如查询 10 个订单及其用户信息：
- ❌ 错误写法：在
Order.Userresolver 里对每个 order 单独查一次SELECT * FROM users WHERE id = ? - ✅ 正确做法：用
github.com/vektah/dataloaden生成 DataLoader，把 10 个 user_id 批量查出来，一次 DB 查询搞定 - ⚠️ 注意：DataLoader 必须绑定到单次 GraphQL 请求的
context.Context生命周期，不能全局复用；Iris 的Context生命周期和 GraphQL 请求不一致，所以必须用原生context管理
如果你用的是 GORM，记得开 Preload 或 Joins；如果用 sqlx，手写 IN (?) 查询 + map[int]*User 映射。没有银弹，只有按需选型。
真正难的从来不是“怎么把 GraphQL 接进 Iris”，而是 resolver 里那几行数据获取代码——它既要看清数据关系，又要扛住并发，还得跟上 GraphQL 的嵌套深度。写完 schema，别急着测前端，先压测下 { orders { user { name } } } 这种两级嵌套，看 DB 连接数和 p95 延迟。
