集成测试应通过 -tags=integration 启动，用 //go:build integration 标识；依赖需随机端口、临时目录和 testcontainers-go 管理；http 测试内建 httptest.server；失败时加健康检查与超时重试。
集成测试该从哪个入口启动？
Go 的集成测试不是靠 go test 自动发现就能跑通的——它必须明确区分单元测试和集成场景，否则容易把数据库、HTTP 服务等外部依赖拖进本地快速验证流程。推荐用 -tags=integration 控制开关，只在 CI 或手动触发时启用。
- 在测试文件顶部加
//go:build integration（Go 1.17+）或// +build integration（旧版） - 运行时显式指定：
go test -tags=integration ./... - 避免在
main_test.go或共用 setup 函数里隐式启动服务，否则普通go test也会尝试连接数据库
如何安全地启动和清理外部依赖？
集成测试失败常因端口冲突、残留数据或未关闭的服务导致。关键不是“能不能跑”，而是“每次是否干净”。以 PostgreSQL 和 HTTP server 为例：
- 用临时目录 + 随机端口：比如
pgx.ConnectConfig{Host: "/tmp", Port: randPort()}，避免硬编码localhost:5432 - 用
testcontainers-go启停容器最稳，但注意它依赖 Docker daemon，CI 中需确认环境就绪 - 清理必须放在
defer里，且检查返回值：defer func() { if err := db.Close(); err != nil { t.Log("close db failed:", err) } }() - 不要依赖
t.Cleanup()处理长时资源（如进程），它只在测试函数返回后执行，若测试 panic 可能跳过
怎么让 HTTP 集成测试不依赖真实域名或配置？
硬写 http://api.example.com 或读取 config.yaml 会让测试在不同环境行为不一致。正确做法是把客户端和服务端都控制在测试进程内：
- 用
httptest.NewUnstartedServer构建 handler，再手动调用Start并绑定随机端口 - 客户端用
http.DefaultClient即可，但 URL 改为http://127.0.0.1:xxxx，别用http://localhost（某些 DNS 解析策略下会变慢或失败） - 若被测服务本身是 CLI 工具或独立进程，用
exec.Command启动，并通过cmd.Process.Kill()确保退出，别只靠cmd.Wait()
测试失败时如何快速定位是代码问题还是环境问题？
集成测试日志里一堆 “connection refused” 或 “timeout” 不代表你的 handler 写错了，很可能是前置服务没起来。加一层轻量级健康检查：
立即学习“go语言免费学习笔记（深入）”；
- 对 DB：执行
SELECT 1；对 HTTP 服务：发 HEAD 请求并检查状态码 - 加超时重试（最多 3 次，每次间隔 100ms），用
time.Sleep而非time.AfterFunc，避免 goroutine 泄漏 - 在错误信息里明确标出依赖类型：
t.Fatalf("postgres not ready after 3 attempts: %v", err) - CI 日志中禁用颜色和进度条（如
psql --no-psqlrc --quiet），避免解析干扰
