单元测试只测函数逻辑、隔离外部依赖,集成测试连真实依赖但需可控可销毁;二者通过构建标签//go:build integration严格分离,子测试t.Run组织多场景用例并确保独立性。

单元测试只测函数逻辑,不碰数据库和网络
单元测试的目标是验证单个函数或 handler 的输入输出是否符合预期,比如 Add 返回正确值、ValidateUser 在邮箱格式错误时返回 ErrInvalidEmail。它必须隔离外部依赖——数据库连接、HTTP 客户端、文件读写统统不能出现。
常见错误现象:TestCreateUser 直接调用真实 PostgreSQL 插入数据,结果本地没装数据库就 panic;或测试里用了全局 http.DefaultClient,导致并发测试互相干扰。
- 用 interface 抽象依赖(如
type UserRepository interface { Save(*User) error }),测试时注入 mock 实现 - HTTP handler 测试优先用
httptest.NewRequest+httptest.NewRecorder,不启动真实 server - 避免在测试中 sleep 等待异步操作完成;改用 channel 或
sync.WaitGroup显式同步
集成测试要连真实依赖,但得可控、可销毁
集成测试不是“把整个服务 docker run 起来再 curl”,而是启动最小闭环:一个带真实 SQLite 内存库的 HTTP server,加一个干净的 http.Client 发请求。它要暴露单元测试发现不了的问题,比如 JSON tag 拼错导致字段为空、事务未提交、SQL 注入过滤失效。
常见错误现象:go test 运行时突然连上生产数据库;多个测试共用同一张表导致数据污染;忘记关闭 test container 导致端口被占。
立即学习“go语言免费学习笔记(深入)”;
- 数据库首选
"sqlite3://:memory:"或testcontainers-go启临时 PostgreSQL 容器 - 集成测试文件统一命名为
*_integration_test.go,开头加构建标签://go:build integration - 用
TestMain统一管理资源生命周期:启动容器 → 运行测试 → 清理容器
用 go test -tags=integration 隔离两类测试
默认 go test 只跑单元测试;集成测试必须显式启用标签,否则 CI 里误跑会拖慢反馈、污染环境。Go 不支持运行时动态开关,全靠构建标签控制编译范围。
参数差异:go test ./... -v 不会执行带 //go:build integration 的文件;而 go test -tags=integration ./... 会跳过所有无该标签的测试。
- 别在单元测试里用
os.Setenv("ENV", "test")模拟集成环境——这属于混淆职责 - CI 中建议分两阶段:先
go test ./...,再go test -tags=integration ./... - 本地开发时,可用 Makefile 封装:
make test-unit和make test-integration
子测试 t.Run 是组织 API 多场景用例的唯一合理方式
同一个 API 接口要测成功、400、401、500 多种响应,不用 t.Run 就只能写一堆重复 setup/teardown,或者用全局变量污染状态。Go 原生支持子测试,且能独立失败、独立计时、独立标记。
容易踩的坑:在 t.Run 闭包里直接用循环变量 tt,导致所有子测试都拿到最后一个值;或在子测试里用 t.Fatal 导致后续用例跳过。
- 务必用
tt := tt捕获循环变量(Go 1.22+ 支持 range 闭包自动绑定,但老版本仍需显式复制) - 子测试内只用
t.Errorf/t.Logf,不要用t.Fatal—— 它会让整个测试函数退出 - 命名带语义:
t.Run("returns_401_when_token_missing", func(t *testing.T) { ... })










