Go / 系统课时

读懂测试失败信息

读懂测试失败信息

go test 失败时,终端通常已经给出了定位所需的第一批证据:失败测试名、源码位置、测试日志、包级 FAIL 和非零退出状态。本节用一个可复现的失败用例拆解这些信息,建立从输出到直接原因的最短判断路径。

学习目标

  • 能从失败输出中定位失败测试与源码位置
  • 能区分测试日志、断言失败和包级失败状态
  • 能利用进程退出状态判断命令是否成功

构造一个可复现的失败

在任意已有 go.mod 的 Go 包目录中创建 price_test.go。测试先记录实际计算结果,再故意使用错误期望值触发失败。

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)
	}
}

预期结果

text
保存 price_test.go 本身不会产生终端输出;执行下方 go test 命令后会稳定得到失败结果。

t.Logf 提供上下文,t.Fatalf 在条件不满足时记录失败原因并立即结束当前测试函数。

同时观察失败信息和退出状态

使用详细模式执行当前包,并在命令结束后打印 shell 看到的退出状态:

bash
go test -v; echo "exit=$?"

预期输出

text
=== 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 日志分析。

按自己的节奏,确认真正理解。

目录与阅读设置

记录一个想法

读懂测试失败信息

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通