go集成测试需用真实依赖（如sqlite、redis）并可控重置状态，通过子测试隔离场景，注重日志与显式断言，支持ci环境且用-tags控制运行。

go test 能跑通不等于服务可靠；单元测试写得再全，跳过集成层照样线上崩。真正的防线在两层之间怎么切、怎么交界、怎么验证。

单元测试必须拒绝网络和真实依赖

微服务里一个 GetUser 函数如果直接调用 http.Get 或 redis.Dial，它就不是单元测试——是带毒的集成测试。这类测试在 CI 上随机失败、本地跑不通、改一行配置全挂。

正确做法是把外部行为抽象成接口，再通过构造函数或方法参数注入：

• 定义 UserRepository 接口，而不是直接 new redis.Client
• 业务逻辑函数接收该接口，而非自己初始化依赖
• 测试时传入 gomock 生成的 Mock 实现，控制返回值与错误
• 每个测试用例必须独立创建 *gomock.Controller，并调用 t.Cleanup(func() { ctrl.Finish() })，否则未满足的 EXPECT 会静默漏掉

别手写 fake 结构体——字段漏加、方法少实现、断言能力弱，维护成本远高于生成成本。

集成测试要启动真实依赖，但不能裸连生产环境

集成测试不是“把单元测试里的 mock 换成 real client”就完事。它得验证组件间真实协作：SQL 查询是否真能映射到 struct、gRPC 请求是否被正确路由、消息序列化后能否被下游反解。

关键约束有三个：

Golang Spf13 Viper

Go 配置库，使用 spf13/viper — 分层优先级（flag > env >file > KV > default），提供 BindPFlag/BindPFlags、SetEnvPrefix + SetEnvKeyReplace 等功能。

下载

• 依赖必须可重复启动：用 testcontainers-go 启 Docker 容器，而不是本地装 MySQL
• 连接地址必须动态获取：容器启动后读取 container.Host() + container.MappedPort()，避免硬编码 localhost:3306
• 资源必须自动清理：用 t.Cleanup() 关闭 DB 连接、删除临时目录、停掉 testcontainer

常见错误是把集成测试写成“本地连我本机的 Redis”，结果换台机器就 fail，CI 环境根本跑不起来。

文件命名和运行方式决定测试层级归属

Go 不靠目录或标签区分测试类型，只看文件名和执行命令：

• xxx_test.go：默认参与 go test，适合单元测试
• xxx_integration_test.go：需显式加 -tags=integration 才运行，防止 CI 默认执行慢测试
• go test -tags=integration ./...：只跑标记了 integration 的文件
• go test -short ./...：配合 if testing.Short() { t.Skip() } 快速跳过耗时集成测试

没加 -tags 就跑通的集成测试，大概率正在拖慢你的本地开发反馈循环。

覆盖率数字没意义，-race 才是底线

85% 覆盖率救不了并发 bug。很多微服务事故源于竞态：两个 goroutine 同时更新缓存、同时写同一张表、同时重试失败请求。这些路径在单线程单元测试里永远触发不了。

• 所有单元测试必须加 -race 参数运行：go test -race -short ./...
• CI 流水线必须将 -race 作为质量门禁，出现 warning 直接失败
• 集成测试也建议加 -race，尤其涉及 HTTP handler、消息消费逻辑时
• 别信 go test -cover 报出来的数字——它不告诉你哪条并发路径没测

真正难测的，从来不是“输入 A 是否返回 B”，而是“100 个请求并发进来，第 47 个会不会把数据库连爆”。那部分，得靠集成层 + race 检测双保险。

golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！