Go / 系统课时
读懂测试失败信息
读懂测试失败信息
go test 失败时,终端通常已经给出了定位所需的第一批证据:失败测试名、源码位置、测试日志、包级 FAIL 和非零退出状态。本节用一个可复现的失败用例拆解这些信息,建立从输出到直接原因的最短判断路径。
学习目标
- 能从失败输出中定位失败测试与源码位置
- 能区分测试日志、断言失败和包级失败状态
- 能利用进程退出状态判断命令是否成功
构造一个可复现的失败
在任意已有 go.mod 的 Go 包目录中创建 price_test.go。测试先记录实际计算结果,再故意使用错误期望值触发失败。
package testingdemo
import "testing"
func TestTotal(t *testing.T) {
price := 20
count := 2
got := price * count
t.Logf("calculated total=%d", got)
if got != 50 {
t.Fatalf("want 50, got %d", got)
}
}预期结果
保存 price_test.go 本身不会产生终端输出;执行下方 go test 命令后会稳定得到失败结果。t.Logf 提供上下文,t.Fatalf 在条件不满足时记录失败原因并立即结束当前测试函数。
同时观察失败信息和退出状态
使用详细模式执行当前包,并在命令结束后打印 shell 看到的退出状态:
go test -v; echo "exit=$?"预期输出
=== RUN TestTotal
price_test.go:<LINE>: calculated total=40
price_test.go:<LINE>: want 50, got 40
--- FAIL: TestTotal (<TIME>s)
FAIL
exit status 1
FAIL <MODULE_PATH> <TIME>s
exit=1<LINE>、<MODULE_PATH> 与 <TIME> 会随文件内容和环境不同而变化。最稳定的判断点是 TestTotal 被标记为 FAIL,错误消息明确显示“期望 50,实际 40”,最后 shell 得到退出状态 1。
按层次读取失败输出
第一层先看具体失败测试。--- FAIL: TestTotal 表明失败发生在 TestTotal。如果一次执行很多测试,不要先被最后的包级 FAIL 吸引,而应向上找到最先出现的具体失败用例。
第二层看源码位置与消息。price_test.go:<LINE> 指向调用 t.Logf 或 t.Fatalf 的位置;紧随其后的文本才是测试作者提供的上下文。在本例中,日志先证明实际计算值为 40,失败消息再证明期望值写成了 50,因此直接原因是期望值与当前计算逻辑不一致。
第三层看命令级状态。末尾的包级 FAIL 表示测试包未通过,shell 中的 exit=1 则表示 go test 以非零状态结束。CI、脚本和 Makefile 主要依赖退出状态决定后续步骤是否继续,因此不能只看有没有打印某条错误文字。
区分常见失败形态
如果输出出现 --- FAIL:,通常说明测试代码已经成功编译并运行,失败来自断言、显式失败调用或 panic。此时优先检查测试名、失败位置和消息。
如果在任何 === RUN 之前就出现编译器错误,例如未定义标识符或类型不匹配,那么测试还没有真正开始执行。此时应先修复构建错误,而不是分析断言。
如果多个测试同时失败,应从第一个具有明确业务信息的失败开始处理,因为后续失败可能只是共享前置条件被破坏后的连锁反应。修复后重新执行最小失败用例,再逐步扩大范围,比直接反复全量执行更容易确认因果关系。
形成固定阅读顺序后,测试失败输出就不再是一段杂乱日志:先定位失败用例,再读取源码位置和消息,最后确认退出状态。这个顺序同时适用于本地排查和 CI 日志分析。