go test -short 跳过集成测试需在测试函数开头显式调用 testing.short() 判断并 t.skip()，配合 *_integration_test.go 文件隔离、t.cleanup() 安全清理、httptest.server 替代真实端口，确保稳定可复现。
Go test -short 怎么跳过集成测试
集成测试通常依赖外部服务（数据库、HTTP 服务、消息队列），跑在 CI 或本地开发时容易失败或拖慢整体测试流程。Go 原生支持用 -short 标志跳过耗时操作，但前提是测试代码主动响应它。
关键不是“加个 flag 就跳过”，而是测试函数里要显式检查 testing.Short() 并提前 return。
- 不检查
testing.Short()的测试，加了-short也照常执行 - 推荐写法：每个集成测试开头加
if testing.Short() { t.Skip("skipping integration test") } - 别把
t.Skip()放在 setup 后面——DB 连接、HTTP server 启动这些可能已经执行并失败了
如何组织 _test.go 文件避免单元测试误触集成逻辑
Go 不强制文件命名规则，但混写会导致 go test 一键运行时把集成逻辑也拉进来，尤其当它们共享变量或 init 函数时。
最稳妥的分离方式是物理隔离 + 命名约定：
立即学习“go语言免费学习笔记（深入）”；
- 单元测试放在
xxx_test.go（如service_test.go） - 集成测试单独建文件，用
xxx_integration_test.go后缀（如service_integration_test.go） - 避免在
*_integration_test.go中 import 单元测试专用的 mock 包，防止隐式耦合 - 如果集成测试需要复用某些 setup 逻辑，抽成独立包（如
testutil），而非直接从*_test.go导出变量
数据库集成测试中 t.Cleanup() 和 defer 的坑
每次集成测试后清空测试库很常见，但清理时机不对会引发 panic 或数据残留。
defer 在函数 return 后执行，而 t.Cleanup() 是在整个测试结束（包括子测试）后统一调用，更可靠：
- 用
defer db.TruncateAll()：如果测试 panic，defer 可能不执行（取决于 panic 是否被 recover） - 用
t.Cleanup(func(){ db.TruncateAll() })：保证执行，且支持多次注册，适合多表清理场景 - 注意：
t.Cleanup()注册的函数不能访问已失效的 t（比如在 goroutine 里异步调用），否则可能 panic - 清理动作本身也要有超时控制，比如
ctx, cancel := context.WithTimeout(context.Background(), 5*time.Second)
HTTP 集成测试里 httptest.Server 和真实端口的区别
用 httptest.NewServer() 启的 server 是内存级的，没走网络栈，快且稳定；但一旦换成真实端口（比如 http.ListenAndServe(":8080", handler)），就引入了端口占用、防火墙、并发冲突等问题。
绝大多数集成场景该用 httptest.Server，除非你明确要测网络层行为：
-
httptest.NewServer()返回的*httptest.Server有URL字段，可直接传给 client，无需拼接 host/port - 真实端口启动后必须手动
server.Close()，否则下次测试可能报address already in use - 如果非要用真实端口（比如测 TLS 握手、代理转发），建议随机端口：
http.ListenAndServe("127.0.0.1:0", handler)，然后从listener.Addr().(*net.TCPAddr).Port拿端口号
集成测试最难的从来不是写逻辑，而是让它们稳定、可复现、不互相污染。环境变量读取顺序、数据库连接池复用、临时目录清理——这些细节不显眼，但一出问题就卡住整个 CI 流水线。
