beego单元测试返回404的根本原因是路由未加载，因测试环境不自动导入routers包；需显式空白导入import _ "github.com/your/app/routers"并验证beego.beeapp.handlers.routes非空。
Beego 单元测试失败多数不是代码写错了，而是 beego.BeeApp.Handlers.ServeHTTP() 根本没路由可匹配——测试环境里路由压根没加载，所有请求都掉进默认 404。
为什么测试总是返回 404
Beego 的路由注册靠 routers/router.go 中的 init() 函数自动触发，但 Go 编译器在测试文件里不会“顺手”导入未显式引用的包。哪怕你调了 beego.TestBeegoInit("github.com/your/app")，它只加载配置、日志、ORM，不碰路由。
- 现象：本地运行正常，测试跑
/api/user永远返回 404 - 验证方式：在
BeforeSuite里加一行beego.Trace("routes:", beego.BeeApp.Handlers.Routes)，输出为空就坐实了 - 根本解法：在测试文件顶部加空白导入 ——
import _ "github.com/your/app/routers" - 路径必须和
go.mod里定义的 module 名一致，比如module github.com/your/app，就不能写成./routers或app/routers
用 Ginkgo + Gomega 写控制器测试
原生 testing 包写 HTTP 层测试容易堆逻辑、断言难读；Ginkgo 的 Describe/It 结构配合 Gomega 的 Equal、ContainSubstring 更贴近真实请求语义。
- 安装：
go get github.com/onsi/ginkgo/v2/ginkgo和go get github.com/onsi/gomega - GET 测试示例：
req, _ := http.NewRequest("GET", "/login", nil)→beego.BeeApp.Handlers.ServeHTTP(w, req)→ 断言w.Code和w.Body.String() - POST 测试需构造表单或 JSON：
req, _ := http.NewRequest("POST", "/login", strings.NewReader(`{"user":"a","pass":"b"}`))，别忘了设req.Header.Set("Content-Type", "application/json") - 注意：不要在测试里重复调
beego.Router()，会污染全局路由表
性能调试要盯住 ORM 查询链
Beego ORM 的 QuerySeter 看似简单，但 N+1 查询、auto_now 字段误用、SELECT * 全字段拉取，三者叠加足以让接口 P95 延迟翻倍。
- 查 N+1：用
o.QueryTable("user").RelatedSel("profile")预加载关联模型，别在循环里反复o.Read() - 查字段冗余：用
.Values(&results, "id", "name", "status")替代.All()，尤其在列表页 - 查时间字段陷阱：频繁更新的字段禁用
auto_now，否则每次Update()都强制改UpdatedAt，即使其他字段没变 - 查慢查询：开启 Beego SQL 日志：
beego.BeeApp.LogLevel = logs.LevelDebug+beego.BeeApp.LogOutput = os.Stdout，观察是否出现重复执行同一 SQL
最常被跳过的一步是验证路由是否真被加载——不是看 TestBeegoInit 是否执行成功，而是看 beego.BeeApp.Handlers.Routes 里有没有你的路径。空的路由表，再好的断言也救不了 404。
