Beego控制器层必须通过HTTP集成测试验证，核心是调用beego.BeeApp.Handlers.ServeHTTP(w, req)触发完整请求链路；需在BeforeSuite中调用beego.TestBeegoInit()初始化配置与路由，路径必须准确，配合Ginkgo+Gomega编写可维护断言。
Beego 的控制器层无法用标准 testing 包直接测通，必须走 HTTP 集成测试路径——即不启服务，但完整走通路由→控制器→响应链路。
beego.TestBeegoInit() 必须在 BeforeSuite 中调用
这个函数不是可选的“初始化辅助”，而是测试环境的基石。它加载 conf/app.conf、注册所有 routers.Init() 定义的路由、初始化 ORM（如果启用）、设置日志级别，但不启动监听端口。
- 路径参数必须准确：传
"github.com/your/app"或AppPath()，不能是"."（除非测试文件就在项目根目录） - 若报错
can't find app.conf，大概率是路径不对或没把conf/目录复制进测试工作目录 - 别在每个
It里重复调用——它会重置整个 Beego 状态，导致后续测试失败
测试 GET 接口要手动构造 http.Request + httptest.NewRecorder
不能用 http.Get()，那会真发网络请求；也不能依赖 Beego 自带的 beego.TestBeegoInit() 后自动开 server——它根本没开。
- 用
http.NewRequest("GET", "/login", nil)创建请求对象 - 用
httptest.NewRecorder()拦截响应，不经过 TCP 层 - 核心调用是
beego.BeeApp.Handlers.ServeHTTP(w, req)，这一步才真正触发路由匹配和控制器执行 - 检查
w.Code、w.Header().Get("Content-Type")、w.Body.String()三者，缺一不可
测试 POST 表单需设置 Content-Type 并写入 body
Beego 的 ParseForm() 依赖 Content-Type: application/x-www-form-urlencoded，否则字段解析为空。
- 构造
url.Values{"username": {"admin"}, "password": {"123"}} - 用
strings.NewReader(v.Encode())把表单转为io.Reader - 创建 request 时指定 body 和 header：
http.NewRequest("POST", "/login", reader)，再调req.Header.Set("Content-Type", "application/x-www-form-urlencoded") - 若接口实际接收 JSON，就改用
application/json，并手动json.NewEncoder(req.Body).Encode(data)
Ginkgo + Gomega 是事实标准，别硬套标准 testing
原生 testing 包缺乏嵌套描述、共享 setup/teardown、语义化断言，写复杂测试极易失控。
- 安装命令必须是
go get github.com/onsi/ginkgo/v2/ginkgo和go get github.com/onsi/gomega（v2 版本） -
Describe描述场景，Context划分条件分支，It写具体断言，结构天然适配 Beego 的路由+控制器分层 - 别用
assert.Equal(t, ...)，Gomega 的Expect(...).To(Equal(...))支持链式、可读错误信息，比如Expected404 to equal 200 - 容易忽略的点：Ginkgo 测试文件名必须以
_test.go结尾，且go test时得用ginkgo命令跑，不是go test
最常卡住的地方不是语法，而是 beego.TestBeegoInit() 路径错、ParseForm() 没设 header、或者忘了 beego.BeeApp.Handlers.ServeHTTP() 这关键一跳——它才是让测试“活起来”的那根线。
