Golang testing.T错误捕获方法详解

答案：使用testing.T结合errors.Is和errors.As可精准验证错误类型与内容，避免直接比较错误字符串，在表驱动测试中统一管理多种错误场景，提升测试健壮性。

在Go语言中，testing.T 是编写单元测试的核心类型，它提供了控制测试流程、输出日志和报告错误的能力。当我们在写测试时，经常会遇到需要验证函数是否返回预期错误的情况。正确使用 testing.T 捕获并断言错误，是保障代码健壮性的关键。

理解 testing.T 的错误处理机制

testing.T 提供了多个方法来报告失败，最常用的是 t.Error、t.Errorf、t.Fatal 和 t.Fatalf。它们的区别在于：

• t.Error 记录错误但继续执行后续逻辑
• t.Fatal 记录错误并立即终止当前测试函数
• 推荐在关键断言失败时使用 t.Fatalf 避免后续无效执行

测试中的“捕获错误”通常是指调用某个函数后，检查其返回的 error 是否符合预期，而不是让程序 panic 或忽略异常。

如何断言函数返回了预期错误

常见的做法是接收函数返回的 error，并使用标准库或第三方断言工具进行判断。以下是几种实践方式：

1. 使用 == 判断 error 是否为 nil 或特定值

func TestDivide(t *testing.T) {
    _, err := divide(10, 0)
    if err == nil {
        t.Fatalf("expected an error when dividing by zero")
    }
    if err.Error() != "cannot divide by zero" {
        t.Errorf("unexpected error message: got %v", err)
    }
}

注意：直接比较 error 字符串不够健壮，建议使用 errors.Is 或 errors.As（Go 1.13+）。

2. 使用 errors.Is 匹配预定义错误

var ErrDivideByZero = errors.New("cannot divide by zero")

func TestDivideWithErrorIs(t *testing.T) {
    _, err := divide(10, 0)
    if !errors.Is(err, ErrDivideByZero) {
        t.Fatalf("expected ErrDivideByZero, got %v", err)
    }
}

这种方式更安全，支持包装后的 error 判断。

3. 使用 errors.As 判断错误类型

type ValidationError struct {
    Msg string
}

func (e *ValidationError) Error() string {
    return e.Msg
}

func TestValidation(t *testing.T) {
    err := validate("")
    var ve *ValidationError
    if !errors.As(err, &ve) {
        t.Fatalf("expected ValidationError, got %T", err)
    }
    if ve.Msg != "input is empty" {
        t.Errorf("unexpected message: %s", ve.Msg)
    }
}

适用于自定义错误类型，能深入检查包装过的 error。

避免常见错误捕获陷阱

在使用 testing.T 时，有几个容易出错的地方需要注意：

• 不要用 t.Log + 忽略判断代替断言 —— 这样测试不会失败
• 避免在 goroutine 中直接调用 t.Error —— 可能导致竞态或 panic
• 如果函数可能 panic，应使用 defer + recover 捕获，再通过 t.Fatal 报告

例如处理 panic 的测试写法：

func TestPanicRecovery(t *testing.T) {
    defer func() {
        if r := recover(); r != nil {
            t.Fatal("function panicked unexpectedly")
        }
    }()
    mightPanic()
}

结合表驱动测试验证多种错误场景

对于多个错误路径，推荐使用表驱动测试统一管理：

func TestProcessInput(t *testing.T) {
    tests := []struct {
        name    string
        input   string
        wantErr bool
    }{
        {"empty input", "", true},
        {"valid input", "hello", false},
        {"too long", strings.Repeat("a", 101), true},
    }

    for _, tt := range tests {
        t.Run(tt.name, func(t *testing.T) {
            err := process(tt.input)
            if tt.wantErr {
                if err == nil {
                    t.Fatal("expected error but got nil")
                }
                return
            }
            if err != nil {
                t.Fatalf("unexpected error: %v", err)
            }
        })
    }
}

这种结构清晰、易于扩展，适合覆盖各种边界条件。

基本上就这些。合理使用 testing.T 结合 errors 包的功能，可以精准捕获和验证错误，提升测试质量。关键是别只看 error 是否存在，还要检查其类型或内容是否符合预期。不复杂但容易忽略细节。