Beego不内置GraphQL支持，需用gqlgen生成服务并接入Beego路由：通过beego.Handler("/graphql", srv)透传请求，复用其中间件；resolver需依赖注入Beego ORM实例，字段命名须避让Get/Post等控制器方法名，确保schema与Go接口严格一致。
Beego 里不直接支持 GraphQL，得自己搭服务层
Beego 本身是 REST-first 的 MVC 框架，没有内置 GraphQL 解析器或执行器。想用 GraphQL，必须把 gqlgen 或自研 resolver 层嵌入 Beego 的 HTTP 路由中，而不是指望 beego.Router() 自动识别 query 字段。常见错误是试图在控制器里手动解析 POST body 中的 GraphQL 字符串——这能跑通但绕过了类型校验、指令处理、字段扁平化等核心能力，后期维护成本陡增。
推荐路径：用 gqlgen 生成 schema + resolver，再让 Beego 的某个路由（如 /graphql）把请求透传给 gqlgen 的 http.HandlerFunc。这样既保留 Beego 的中间件（鉴权、日志、CORS），又复用 gqlgen 的执行引擎。
用 gqlgen 初始化后如何接入 Beego 路由
执行 gqlgen init 后会生成 server.go，里面默认用 http.ListenAndServe 启服务。你要删掉它，改用 Beego 的 beego.Handler() 注册子路由：
package main
import (
"github.com/astaxie/beego"
"github.com/99designs/gqlgen/graphql/handler"
"your-project/generated"
"your-project/resolvers"
)
func main() {
// 初始化 gqlgen server
srv := handler.NewDefaultServer(generated.NewExecutableSchema(
generated.Config{Resolvers: &resolvers.Resolver{}},
))
// 接入 Beego：/graphql 路由交由 gqlgen 处理
beego.Handler("/graphql", srv)
// 其他 Beego 路由照常注册
beego.Router("/api/users/:id", &controllers.UserController{}, "get:Retrieve")
beego.Run()
}
注意三点：
-
beego.Handler()不走控制器生命周期，所以Prepare()、Finish()等方法对 GraphQL 请求无效；中间件需改用beego.InsertFilter()针对路径注册 - GraphQL 请求体是 JSON，Content-Type 必须为
application/json，否则gqlgen默认返回 405 - Beego 默认开启 XSRF 保护，而 GraphQL 请求通常带
X-Requested-With: GraphQL，需在配置中关闭：beego.BConfig.WebConfig.XSRFKey = ""
Resolver 访问 Beego ORM 或上下文时的坑
Resolver 函数签名是 func(...)(result, error)，没有 Beego 的 ctx.Input 或 orm 实例。强行在 resolver 里调 orm.NewOrm() 会导致连接泄漏或事务错乱——因为 Beego 的 ORM 是 per-request 绑定的。
正确做法是把依赖注入 resolver 结构体：
type Resolver struct {
orm *orm.Ormer // 从 Beego 控制器或初始化逻辑中传入
ctx context.Context
}
func (r *Resolver) Query() QueryResolver {
return &queryResolver{r: r}
}
func (r *Resolver) Mutation() MutationResolver {
return &mutationResolver{r: r}
}
然后在 main() 初始化时传入：
o := orm.NewOrm()
srv := handler.NewDefaultServer(generated.NewExecutableSchema(
generated.Config{Resolvers: &resolvers.Resolver{
orm: &o,
ctx: context.Background(), // 或从 Beego 中间件提取真实 ctx
}},
))
更稳妥的方式是用 Beego 的 AppConfig 或全局变量管理 ORM 实例，避免每次请求都新建。
Schema 设计要避开 Beego 的命名冲突
Beego 默认控制器方法名是 Get()、Post()、Put()，而 GraphQL 的 Query 类型里如果定义了 getUsers 字段，resolver 方法也叫 GetUsers，Go 编译器不会报错，但 gqlgen 生成代码时可能因大小写或前缀规则误判为 Beego 控制器方法，导致 schema 加载失败或字段为空。
规避方式：
- GraphQL 字段名统一用小驼峰：
users、userById，别用getUsers - Resolver 方法名按
gqlgen规范来：Users、UserById，首字母大写即可，不加Get/Find前缀 - 如果已有 Beego 控制器用了
GetUser，GraphQL Schema 里就改用别名：user: getUser(id: ID!) @deprecated(reason: "Use userById instead")
真正容易被忽略的是：Beego 的 Router 和 GraphQL 的 schema.graphqls 是两套独立的契约，改了一边不验证另一边，上线后前端查不到字段却收不到编译错误——务必用 gqlgen generate 后手动比对生成的 Go 接口与 Beego 控制器是否意外重名。
