Go单元测试中如何验证error正确性_Go测试Error断言技巧

P粉602998670 2025-12-22 00:00:00 次阅读

Go单元测试验证error的核心是检查是否为nil、是否为预期类型、是否匹配预期错误；优先用errors.Is和errors.As，避免字符串比较。

在 Go 单元测试中验证 error 是否正确，核心是：检查 error 是否为 nil、是否为预期类型、是否包含预期内容。不推荐用字符串比较（脆弱），应优先用类型断言 + 错误判等标准方式。

检查 error 是否为 nil 或非 nil

这是最基础也最容易出错的一步。很多测试只关注“成功路径”，却忽略对错误路径的显式校验。

期望函数成功 → error 应为 nil
期望函数失败 → error 应 非 nil，且需进一步验证其性质

示例：

err := doSomething()
if err != nil {
    t.Fatal("expected no error, got:", err)
}

用 errors.Is 判断底层错误是否匹配

适用于包装错误（如 fmt.Errorf("wrap: %w", err) 或 errors.Wrap）场景，能穿透多层包装找到原始错误。

使用 errors.Is(err, targetErr) 判断是否等于某个已知错误变量（如 io.EOF、自定义包级变量 ErrNotFound）
避免硬编码字符串，也不依赖错误的完整文本

示例：

var ErrNotFound = errors.New("not found")

func TestFetchUser(t *testing.T) {
    _, err := FetchUser(999)
    if !errors.Is(err, ErrNotFound) {
        t.Fatalf("expected ErrNotFound, got %v", err)
    }
}

用 errors.As 断言错误类型（含自定义错误）

当需要访问错误的结构体字段（比如 HTTP 状态码、错误码 code、详情 message）时，必须用 errors.As 做类型断言。

适用于实现了 error 接口的自定义结构体错误
比直接用 err.(*MyError) 更安全（自动处理包装）

示例：

type ValidationError struct {
    Code    int
    Message string
}
func (e *ValidationError) Error() string { return e.Message }

// 测试中：
var ve *ValidationError
if errors.As(err, &ve) {
    if ve.Code != 400 {
        t.Errorf("expected code 400, got %d", ve.Code)
    }
} else {
    t.Error("error is not *ValidationError")
}