Go测试核心在于依赖隔离、状态清洁与命名规范:测试文件必须为xxx_test.go且与被测代码同包;依赖须用接口注入而非硬编码;HTTP依赖优先用httptest.Server可控模拟。

Go 语言测试环境不需要“搭建独立测试环境”,直接用 go test 就是标准自测入口——关键在于你写的测试脚本是否隔离依赖、可重复、不污染状态。
test 文件必须叫 xxx_test.go 且和被测代码同包
这是硬性约定,不是可选项。如果文件名是 utils_test.go 但放在 pkg/utils/ 目录下,而被测的 utils.go 也在同一目录、同 package,才能直接调用未导出函数(比如 parseConfig 这种小写开头的)。
常见错误:
- 新建了
test/main_test.go却想测pkg/service.go—— 跨包访问私有函数会编译失败 - 文件名写成
utils-tests.go或test_utils.go——go test完全忽略 - 测试文件 package 声明为
package main—— 无法导入被测包,也无法被go test识别
用接口注入替代硬编码依赖(比如 HTTP client、DB)
不要在业务代码里直接写 http.Get(...) 或 sql.Open(...),否则测试时只能 mock 全局变量(脆弱)或改源码(不可持续)。正确做法是把依赖抽象成接口,构造函数传入:
立即学习“go语言免费学习笔记(深入)”;
例如被测服务定义为:
type HTTPClient interface {
Do(*http.Request) (*http.Response, error)
}
func NewUserService(client HTTPClient) *UserService { ... }
测试时传个 fake:
type fakeHTTPClient struct{}
func (f fakeHTTPClient) Do(req *http.Request) (*http.Response, error) {
return &http.Response{
StatusCode: 200,
Body: io.NopCloser(strings.NewReader(`{"id":"1"}`)),
}, nil
}
这样既不用改业务逻辑,又彻底绕过真实网络请求。
用 httptest.Server 构造可控的 HTTP 依赖服务
当你要验证超时、503、连接中断等真实网络异常时,mock 接口太“干净”,必须起一个真实但可编程的 HTTP server。
注意点:
-
httptest.NewServer返回的*httptest.Server必须在测试结束前调用.Close(),否则端口泄漏、下次测试 bind 失败 - handler 里不加随机逻辑,它就永远返回 200 —— 比如要模拟 10% 的 503,得手动写
if rand.Float64() - 别忘了给 client 配超时:
client := &http.Client{Timeout: 100 * time.Millisecond},否则即使 server sleep 2s,测试也不会报错
并发测试要防竞态,别用全局变量计数
如果你写的是压力类自测(比如验证限流器是否生效),多个 goroutine 同时修改 count++ 会导致结果不准甚至 panic。
正确方式是用 sync/atomic:
var successes int64
var failures int64
<p>for i := 0; i < 100; i++ {
go func() {
_, err := client.Do(req)
if err != nil {
atomic.AddInt64(&failures, 1)
} else {
atomic.AddInt64(&successes, 1)
}
}()
}
还有两个容易被忽略的点:一是 http.DefaultClient 的 Transport 默认只保持 2 个空闲连接,压不出并发;二是 DNS 解析慢会卡住整个请求,建议用 IP 测试或显式配置 DialContext。


















