beego.testbeegoinit()需配合路由包导入才生效，否则路由为空导致404；测试中应使用servehttp模拟真实请求链，避免手动new controller；推荐ginkgo+gomega组织测试，注意post时content-type与参数解析方式匹配。
beego.TestBeegoInit() 必须配合路由包导入才能生效
单独调用 beego.TestBeegoInit("path/to/app") 不会自动加载路由，这是 404 错误最常见原因。Beego 的路由注册依赖 Go 的 init() 函数执行，而测试文件默认不触发未被显式导入的包初始化。
必须在测试文件顶部添加空白导入：
-
import _ "your-module/routers"（路径需与go.mod中模块名一致） - 若使用相对路径，确保
beego.TestBeegoInit()的参数能正确定位conf/app.conf，推荐用filepath.Join("..", "..")或beego.AppPath - 可加一行日志验证：
beego.Trace("Routes:", beego.BeeApp.Handlers.Routes)，输出为空说明导入失败或路径错误
用 beego.BeeApp.Handlers.ServeHTTP() 模拟真实请求链
不要手动 new Controller 实例再调用方法——这绕过了中间件、参数绑定、Session/Flash 等 Beego 运行时上下文，测的不是真实行为。
正确方式是复用 Beego 内置 Handler 树：
req, _ := http.NewRequest("GET", "/login", nil)w := httptest.NewRecorder()beego.BeeApp.Handlers.ServeHTTP(w, req)- 此时
w.Code、w.Body.String()、w.Header()即为完整 HTTP 响应结果
注意：该方式不启动网络端口，无性能开销，但要求路由、配置、ORM（如启用）均已通过 TestBeegoInit 和路由导入就绪。
Ginkgo + Gomega 是控制器测试的事实标准
原生 testing 包写 Beego 控制器测试易冗余、难组织，尤其涉及嵌套场景（如登录后访问受保护接口）时状态管理混乱。
Ginkgo 提供语义化结构，Gomega 提供可读断言：
- 安装：
go get github.com/onsi/ginkgo/v2/ginkgo+go get github.com/onsi/gomega - 入口文件必须为
*_suite_test.go，含RunSpecs(t, "MyApp Suite") - 用
Describe("GET /api/user")+It("returns 200 with JSON")清晰表达意图 - 断言推荐：
Expect(w.Code).To(Equal(http.StatusOK))、Expect(w.Body.String()).To(MatchJSON(`{"id":1}`))
避免把所有逻辑塞进一个 It；每个 It 应只验证一个明确行为，比如“带有效 token 能获取用户”，而不是“token 无效时返回 401 + token 有效时返回 200”混在一起。
POST 表单和 JSON 请求的参数处理差异
Beego 对不同 Content-Type 的解析逻辑不同，测试时必须匹配真实客户端行为。
表单提交（application/x-www-form-urlencoded）：
- 用
req.PostForm = url.Values{"username": {"admin"}, "password": {"123"}} - 或构造 body：
body := strings.NewReader("username=admin&password=123")，再设req, _ := http.NewRequest("POST", "/login", body)并手动设置req.Header.Set("Content-Type", "application/x-www-form-urlencoded")
JSON 提交（application/json）：
- body 必须是合法 JSON 字符串：
body := strings.NewReader(`{"username":"admin","password":"123"}`) - 必须设置
req.Header.Set("Content-Type", "application/json") - Controller 中需用
this.ParseForm(&user)或json.Unmarshal(this.Ctx.Input.RequestBody, &user)，测试前确认你用的是哪一种
漏设 Content-Type 或类型不匹配，会导致 this.Input().Get("xxx") 返回空或解析失败，但不会报错——这是静默失败的高发点。
