Go集成测试环境靠代码组织构建，TestMain统一管理生命周期，用-tags=integration开关，数据库动态建库并自动迁移，HTTP测试用随机端口和超时控制。
集成测试环境在 Go 中不是靠“配置”出来的，而是靠代码组织和依赖管理构建出来的——没有全局配置文件，关键在于测试如何启动服务、清理资源、隔离状态。
如何用 testmain 统一管理集成测试生命周期
Go 的 TestMain 是控制集成测试启停的最常用入口。它让你在所有 Test* 函数运行前启动数据库、HTTP 服务等依赖，并在结束后关闭它们。
- 必须在
func TestMain(m *testing.M)中调用os.Exit(m.Run())，否则测试会卡住或不执行 - 不能在
TestMain里直接写断言逻辑，它只负责准备和收尾；具体测试仍要放在Test*函数里 - 若多个测试包共用一套外部服务（如一个共享 PostgreSQL 实例），需加锁或使用随机端口/数据库名避免冲突
示例片段：
func TestMain(m *testing.M) {
// 启动本地 Postgres 容器（比如用 testcontainers-go）
ctx := context.Background()
pg, _ := testcontainers.GenericContainer(ctx, testcontainers.GenericContainerRequest{
ContainerRequest: testcontainers.ContainerRequest{
Image: "postgres:15",
Env: map[string]string{"POSTGRES_PASSWORD": "test"},
ExposedPorts: []string{"5432/tcp"},
},
Started: true,
})
defer pg.Terminate(ctx)
// 设置连接字符串到全局变量或 test helper
dbURL, _ := pg.ConnectionString(ctx, "sslmode=disable")
os.Setenv("DATABASE_URL", dbURL)
os.Exit(m.Run())
}
为什么 go test -tags=integration 是推荐的开关方式
用构建标签区分单元测试与集成测试，能避免 CI 频繁拉起重资源，也防止本地误跑耗时操作。
立即学习“go语言免费学习笔记（深入）”；
- 在集成测试文件顶部加
//go:build integration（Go 1.17+）或// +build integration（旧版） - 对应测试函数保持普通命名（
func TestUserCreate(t *testing.T)），无需特殊前缀 - 运行时必须显式启用：
go test -tags=integration ./...；默认不运行，也不会报错 - 如果混用
-race或-cover，注意-tags要放在最前面，否则可能被忽略
数据库迁移如何在测试中自动执行而不污染开发环境
集成测试需要干净、可重复的数据库状态，不能复用开发库，也不能手动执行 SQL。
- 推荐在
TestMain或每个测试函数开头，用goose/migrate等工具指向测试专用的schema.sql或 migration 目录 - 数据库名建议动态生成（如
"testdb_" + strconv.Itoa(os.Getpid())），避免并发测试冲突 - 务必在测试结束时
DROP DATABASE或清空表，否则残留数据会影响下次运行 - 不要在
init()中做迁移——它会在包加载时执行，无法控制时机，且对非测试构建造成干扰
HTTP 集成测试中如何避免端口占用和超时陷阱
启动真实 HTTP 服务做集成测试时，硬编码端口（如 :8080）极易导致冲突或假失败。
- 用
net.Listen("tcp", ":0")让系统分配空闲端口，再通过l.Addr().(*net.TCPAddr).Port获取实际值 - 客户端请求必须用完整地址（如
http://localhost:54321/api/users），不能只写路径 - 给
http.Client显式设置Timeout（如 5 秒），否则默认无超时，测试会挂死 - 服务启动后应加简单健康检查（如 GET /health 返回 200），而不是 sleep 固定时间——容器启动延迟不可控
真正难的不是启动服务，而是让每次测试都像第一次那样干净：临时数据库、临时端口、临时目录、临时配置。这些细节不封装好，集成测试就会从验证工具变成定时炸弹。
