Golang如何使用testing.T处理错误断言

使用*testing.T处理错误需及时检查error并调用t.Error、t.Errorf或t.Fatal防止后续执行。1. 调用函数后先判断error是否为nil，非nil时根据情况使用t.Errorf或t.Fatalf报告；2. 验证特定错误信息可用errors.Is、errors.As或strings.Contains检查内容；3. 封装常用断言为辅助函数并调用t.Helper()定位错误行号；4. 子测试中独立处理错误，结合t.Run隔离测试用例。核心是明确预期、及时终止、清晰提示。

在 Go 的 testing 包中，*testing.T 是编写测试的核心类型。处理错误断言的关键在于：及时检查错误并使用 T.Error、T.Errorf 或 T.Fatal 等方法报告问题，避免后续代码在错误状态下继续执行。

1. 基本错误检查与断言

函数调用后通常返回 (result, error)。测试中应先判断 error 是否为 nil。

– 如果 error 不为 nil，说明预期外的错误发生，应报错。
– 使用 T.Errorf 记录错误但继续执行，适合非致命错误。
– 使用 T.Fatalf 报错并终止当前测试函数，防止对 nil 结果解引用等 panic。

示例：

func TestDivide(t *testing.T) {
result, err := divide(10, 0)
if err == nil {
t.Fatal("expected error when dividing by zero, but got none")
}
if result != 0 {
t.Errorf("expected result 0, got %f", result)
}
}

2. 验证特定错误信息

有时不仅要判断是否有错误，还需确认错误内容是否符合预期，比如自定义错误提示。

立即学习“go语言免费学习笔记（深入）”；

– 使用 errors.Is 或 errors.As 判断错误类型（Go 1.13+）。
– 直接比较错误消息字符串时建议用 strings.Contains，避免完全匹配导致脆弱测试。

示例：

func TestInvalidInputError(t *testing.T) {
_, err := processInput("")
if err == nil {
t.Fatal("expected error for empty input")
}
if !strings.Contains(err.Error(), "input cannot be empty") {
t.Errorf("error message does not contain expected text: %v", err)
}
}

3. 使用辅助函数简化断言

重复的错误检查逻辑可以封装成辅助函数，提升可读性。

例如：

func assertError(t *testing.T, err error, contains string) {
t.Helper()
if err == nil {
t.Fatal("expected an error but got nil")
}
if !strings.Contains(err.Error(), contains) {
t.Errorf("error message %q does not contain %q", err.Error(), contains)
}
}
<p>func TestWithHelper(t *testing.T) {
_, err := doSomething()
assertError(t, err, "failed to connect")
}

注意：辅助函数中调用 t.Helper() 可让错误定位到调用者行号，而非辅助函数内部。

4. 处理多个子测试中的错误

使用 t.Run 执行子测试时，每个子测试应独立处理错误。

func TestMultipleCases(t *testing.T) {
tests := []struct {
name     string
input    int
hasError bool
}{
{"valid", 5, false},
{"zero", 0, true},
}
<pre class="brush:php;toolbar:false;"><pre class="brush:php;toolbar:false;">for _, tt := range tests {
t.Run(tt.name, func(t *testing.T) {
_, err := divide(10, tt.input)
if tt.hasError && err == nil {
t.Fatal("expected error but got nil")
}
if !tt.hasError && err != nil {
t.Fatalf("did not expect error, but got: %v", err)
}
})
}

}

基本上就这些。关键是清晰表达预期，及时中断无效路径，并给出明确错误信息。不复杂但容易忽略细节。