go get 安装 ginkgo/gomega 失败是因为未初始化 Go Modules，需先在项目根目录执行 go mod init，再 go get 并 go mod tidy；beego.TestBeegoInit() 失败主因是 routers.Init() 未先调用或 conf/app.conf 路径错误；HTTP 测试 404 源于控制器未注册、模板路径错或未走内存路由；Ginkgo 测试须用 ginkgo 命令而非 go test。
go get 安装 ginkgo/gomega 会失败？先确认模块初始化
直接运行 go get github.com/onsi/ginkgo/v2/ginkgo 或 go get github.com/onsi/gomega 报错 no required module provides package，几乎都是因为当前目录没启用 Go Modules。Beego v2 项目必须基于模块管理，否则测试工具无法正确解析依赖。
解决方法很简单：
- 进入你的 Beego 项目根目录（含
main.go和routers/router.go） - 执行
go mod init myapp（myapp换成你自己的模块名，如example.com/photo） - 再运行
go get github.com/onsi/ginkgo/v2/ginkgo和go get github.com/onsi/gomega - 最后执行
go mod tidy补全依赖并写入go.sum
不初始化模块就装测试包，Go 会拒绝写入 go.mod，后续所有测试命令（如 ginkgo -r）都会找不到入口。
beego.TestBeegoInit() 初始化失败？路径和路由加载顺序是关键
测试文件里调用 beego.TestBeegoInit(".') 却提示配置未加载、路由为空或 panic: nil pointer，常见原因是初始化时机不对或路径指向错误。
必须满足两个条件：
-
beego.TestBeegoInit()要在routers.Init()之后调用——Beego 的测试初始化依赖已注册的路由表，而routers.Init()才真正执行beego.Router()等注册逻辑 - 传入的路径参数必须能定位到
conf/app.conf；如果测试文件放在tests/子目录下，"."就会找错位置，应改用filepath.Join("..", "..")或绝对路径 - 确保
conf/app.conf文件存在且语法合法（比如没有 UTF-8 BOM、section 名拼写正确）
漏掉 routers.Init() 或路径偏差，beego.BeeApp.Handlers 就是空的，后面用 httptest 发请求必然 404 或 panic。
测试 HTTP 接口时 404 或返回空内容？检查控制器注册和模板路径
写了 Describe("GET /login", func() { ... })，但 w.Code 是 404，或 w.Body.String() 为空，不是代码逻辑问题，而是 Beego 运行时环境没对齐。
重点核对三点：
- 控制器是否已注册：确认
routers/router.go中有类似beego.Router("/login", &controllers.LoginController{}, "get:Login")的语句，且控制器 struct 继承的是web.Controller（v2 写法），不是beego.Controller - 模板文件是否存在：如果控制器调用了
this.TplName = "login.tpl"，要确认该文件在views/login.tpl（路径区分大小写） - 测试中没启动完整服务：别用
http.Get()去访问localhost:8080，那是在测真实进程；单元测试必须走beego.BeeApp.Handlers.ServeHTTP(w, req)这条内存内路由链
Beego 测试不走网络栈，所有路由、中间件、模板渲染都在内存完成。一旦注册漏掉或路径错位，就彻底绕过控制器，直接 404。
ginkgo test 命令不识别？别用 go test 直接跑
执行 go test ./... -v 看不到 Ginkgo 的 Describe/It 输出，或者报 undefined: Describe，说明没用对执行器。
Ginkgo v2 不兼容原生 go test，必须用它自己的二进制：
- 安装后，用
ginkgo命令（不是go test）运行测试：例如ginkgo -r -v tests/ - 确保测试文件名以
_test.go结尾，且包声明是package tests或与主应用同包（推荐独立tests包） - 如果提示
command not found: ginkgo，说明ginkgo二进制没进 PATH——它默认装在$GOPATH/bin，和bee一样需要手动加进系统环境变量
最常被忽略的一点：Ginkgo v2 的 CLI 已完全重写，ginkgo -r 是唯一推荐方式，go test -run 无法触发它的 DSL 语法解析。
