Go测试失败常因测试写法错误:未隔离依赖、忽略错误、并发不同步或命令误用;单测需进包目录执行go test,而非直接指定文件;HTTP handler测试须传context并用httptest工具;表驱动测试需覆盖边界条件并标注错误预期。

Go测试中失败不等于代码有bug,更多时候是测试写法本身出了问题——比如没隔离依赖、忽略错误返回、并发没同步,或者连go test命令都用错了。
go test file_test.go 为什么总报 undefined?
这是新手最常撞上的墙:直接指定测试文件运行,结果找不到同包函数。
-
go test t1_test.go只编译这个文件,不会自动拉入t1.go,所以SayHI()报undefined - 正确做法是进包目录后执行
go test(不带参数),让工具自动发现整个包的源文件和测试文件 - 若真要单测某个函数,可用
-run过滤:go test -run TestAdd - 想快速验证修改?加
-short跳过耗时测试,但别在 CI 里依赖它
HTTP handler 测试里 goroutine 泄漏怎么查?
在 http.HandlerFunc 中起 goroutine 却不传 context.Context,测试一跑完就 panic 或静默失败。
- handler 返回后,
*http.Request和http.ResponseWriter已失效,goroutine 若还在读写它们就会崩 - 测试中模拟请求要用
httptest.NewRequest+httptest.NewRecorder,不能手造指针 - 若逻辑必须异步,务必把
req.Context()传进去,并在测试中用context.WithTimeout控制生命周期 - 漏掉这步,
go test -race很可能报 data race,但不是每次都能复现
表驱动测试总漏掉关键路径?
写了一堆 case,覆盖率看着高,但除零、空字符串、超长输入这些边界全没覆盖,等于白测。
立即学习“go语言免费学习笔记(深入)”;
- 别只列“正常输入→期望输出”,每个 case 必须明确标注
hasError bool或shouldPanic bool - 常见遗漏点:
nil指针入参、负数索引、UTF-8 截断、JSON 字段缺失、time.Time 零值 - 用
reflect.DeepEqual比对结构体,但注意它不比较 unexported 字段;需要深比对字段时,手动展开或用cmp.Equal - 测试名别叫
TestFunc,写成TestDivide_ByZeroReturnsError,失败时一眼知道哪条路没走通
最隐蔽的坑不在代码里,在测试的“假设”里——比如默认时间是本地时区、数据库连接永远成功、配置文件一定存在。这些假设一旦在 CI 或其他环境失效,测试就变成随机性噪音。










