iris 框架不内置 graphql 支持，需通过 http 层桥接 gqlgen 等执行器：解析 json 请求、调用 graphql.do()、返回结果；需手动处理 content-type 校验、错误透传及依赖注入。
Iris 框架本身不内置 GraphQL 支持，它没有像 Spring Boot 那样的 spring-boot-starter-data-graphql，也没有像 Express + express-graphql 那样开箱即用的官方绑定。想在 Iris 中接入 GraphQL，核心思路是：**把 GraphQL 执行器（如 graphql-go/graphql 或 vektah/gqlgen）当作纯 Go 逻辑嵌入 HTTP 路由，由 Iris 负责接收请求、解析 body、返回响应，不参与 schema 构建或 resolver 调度**。
为什么不能直接用 @GraphQLQuery 这类注解？
Iris 是 Go 语言 Web 框架，Go 没有运行时反射注解（如 Java 的 @GraphQLQuery），更不存在 Spring 风格的自动扫描和依赖注入机制。所有 resolver 必须显式注册、手动调用。所谓“集成”，其实是 HTTP 层桥接，不是框架级融合。
Iris + gqlgen 是目前最稳的组合
gqlgen 是 Go 生态事实标准的 GraphQL 代码生成器，它根据 schema.graphql 生成类型定义和 resolver 接口，你只需实现接口方法。与 Iris 配合时，关键就两步：
- 用
gqlgen generate生成generated.go和models_gen.go - 写一个符合
gqlgen要求的Resolver结构体，实现所有Mutation/Query方法 - 在
Iris路由中，用ctx.ReadBody()解析 JSON 请求，调用graphql.Do()执行，再用ctx.JSON()返回结果
示例片段（非完整服务）：
app.Post("/graphql", func(ctx iris.Context) {
var req graphql.GraphQLRequest
if err := ctx.ReadJSON(&req); err != nil {
ctx.StatusCode(400)
ctx.JSON(iris.Map{"error": "invalid json"})
return
}
result := graphql.Do(graphql.Params{
Schema: generated.Schema,
OperationName: req.OperationName,
Query: req.Query,
Variables: req.Variables,
Context: ctx.Request().Context(),
})
ctx.JSON(result)
})
容易踩的坑：HTTP 方法、MIME 类型、错误透传
Iris 默认不校验 Content-Type: application/json，但 graphql-go 系列库要求严格匹配，否则 variables 解析为空。必须加中间件拦截：
- 拒绝
GET请求（GraphQL 标准只推荐POST，GET需手动解析 URL 查询参数，易出错） - 检查
ctx.GetHeader("Content-Type")是否包含application/json，否则返回415 Unsupported Media Type -
graphql.Do()返回的result.Errors是 slice，需手动转成 JSON 可序列化的结构，否则ctx.JSON()会丢掉错误详情 - 别直接用
ctx.StatusCode(200)—— GraphQL 响应体里可能含"errors"字段，状态码仍应为200（这是规范）
要不要用 graphql-go/graphql 而不是 gqlgen？
可以，但不推荐。前者是低阶 API，你要自己写 schema AST、手动绑定 resolver 函数、处理字段参数、管理 context 传递；后者通过 schema 优先（SDL-first）自动生成强类型代码，编译期就能发现 resolver 缺失或签名错误。在 Iris 这种无侵入式框架里，gqlgen 的类型安全收益远大于配置成本。
真正复杂的地方不在路由桥接，而在于 resolver 内部如何复用 Iris 的依赖（比如数据库连接池、日志实例）。这些得靠你手动注入到 Resolver 结构体字段里——Iris 不管这事，它只管 HTTP。
大量免费API接口：立即使用
涵盖生活服务API、金融科技API、企业工商API、等相关的API接口服务。免费API接口可安全、合规地连接上下游，为数据API应用能力赋能！
