Beego项目中tests/目录不能作为测试垃圾桶，因其默认仅支持单元测试：未加载配置、未初始化ORM、未启动HTTP服务，导致集成测试连接数据库失败或请求被拒绝；必须将集成测试拆分为tests/integration/app_test.go（初始化全链路）、user_api_test.go（业务API测试）和db_helper.go（事务隔离清理），并显式控制配置加载、ORM注册与服务启停。
Beego 项目里写集成测试，不能把 tests/ 目录当成“测试垃圾桶”——它得和 controllers/、models/ 一样有明确职责边界，否则测试一跑就 panic，连数据库连接都建不起来。
为什么 tests/ 目录默认结构撑不住集成测试
beego 默认生成的 tests/default_test.go 是单元测试模板：只初始化了路由、没加载配置、没启动 ORM、也没 mock HTTP 请求上下文。你直接往里塞 curl http://localhost:8080/api/users 这类调用，会报 connection refused；想查数据库？o := orm.NewOrm() 会 panic，因为 orm.RegisterDriver 和 orm.RegisterDataBase 根本没执行。
根本原因是：集成测试需要复现真实请求生命周期——从 HTTP 入口、中间件、控制器、模型、到数据库往返。这要求测试代码能主动控制服务启停、配置加载、依赖注入。
- 默认
tests/下的测试文件不 importconf/和routers/，app.conf里的runmode = dev或数据库地址全失效 -
bee run启动的服务监听localhost:8080，但测试进程是独立的，无法共享内存或 DB 连接池 - beego 的
beego.TestBeegoInit只做最小初始化，不等价于beego.Run()，很多钩子（如AppStart）不会触发
tests/integration/ 目录必须包含哪些文件
把集成测试单独拎到 tests/integration/，并强制约定以下三个文件，才能稳定跑通端到端流程：
-
tests/integration/app_test.go：唯一入口，负责调用beego.TestBeegoInit+ 手动加载conf/app.conf+ 初始化 ORM + 启动 test server（用beego.BeeApp.StartServer） -
tests/integration/user_api_test.go：按业务域拆分，比如用户相关 API 就放这里，用http.DefaultClient发真实请求，断言 JSON 响应 -
tests/integration/db_helper.go：封装测试前后 DB 清理逻辑，例如在TestMain里执行TRUNCATE TABLE users，避免测试间数据污染
示例关键片段（app_test.go）：
func TestMain(m *testing.M) {
beego.TestBeegoInit("http://127.0.0.1:8080")
// 手动加载配置
beego.LoadAppConfig("ini", "conf/app.conf")
// 初始化 ORM（注意 driver name 必须和 app.conf 里 db 配置一致）
orm.RegisterDriver("mysql", orm.DRMySQL)
orm.RegisterDataBase("default", "mysql", beego.AppConfig.String("db::dsn"))
os.Exit(m.Run())
}
测试时如何绕过中间件又不破坏真实链路
集成测试要测的是“控制器+模型+DB”这条主干，但登录校验、IP 限流这类中间件会拦截请求，导致 401 或 429，不是你想验证的逻辑。
别注释中间件，也别写 if beego.BConfig.RunMode == "test" —— 这会让测试环境和线上行为不一致。正确做法是：
- 在
routers/router.go里把中间件注册逻辑抽成函数，比如RegisterAuthMiddleware() - 在
tests/integration/app_test.go中只调用beego.Router注册路由，跳过中间件注册步骤 - 如果必须测带中间件的路径，用
beego.InsertFilter在测试内临时注入一个空中间件，而不是改全局配置
这样既保持主流程干净，又保留了对中间件单独测试的能力（可另建 tests/middleware/ 目录）。
数据库连接和事务隔离的坑
多个集成测试并发跑时，INSERT INTO users 会互相干扰，尤其是测试用自增 ID 断言时，极易失败。
最稳妥的方式不是用内存 SQLite，而是利用 MySQL 的事务隔离特性：
- 每个测试函数开头用
o.Begin()开启事务 - 结尾统一
o.Rollback()（不是Commit），确保数据不留痕 - 注意：beego ORM 的
Begin()返回的是*orm.Transaction，不是全局orm.Ormer，所有操作必须用该事务对象 - 避免在
TestMain里初始化全局 ORM 实例，否则事务会跨测试污染
这比写 Docker Compose 起临时 MySQL 容器轻量得多，也比 mock 数据库更贴近真实。
真正麻烦的从来不是写测试代码，而是让测试进程和主应用共享同一套初始化逻辑却不互相干扰——目录结构只是表象，关键是把配置加载、ORM 初始化、HTTP Server 启停这三件事的控制权，从 main.go 显式移交到测试入口里。
