Golang错误断言测试技巧分享

大家好，我们又见面了啊~本文《Golang错误断言测试方法详解》的内容中将会涉及到等等。如果你正在学习Golang相关知识，欢迎关注我，以后会给大家带来更多Golang相关文章，希望我们能一起进步！下面就开始本文的正式内容~

验证错误需分层断言：存在性（err != nil）、身份（errors.Is）、类型（errors.As）、消息（strings.Contains），优先选契约强的层级，避免脆弱匹配。

测试返回错误的函数，核心是验证错误是否符合预期——类型、内容、是否为 nil。Golang 本身不提供内置断言，需结合 if err != nil 判断 + 手动比对，或借助标准库 errors.Is / errors.As 和测试工具（如 testify/assert）提升可读性与健壮性。

基础错误存在性检查

最简方式：调用函数后直接判断 err 是否为 nil，适用于只关心“是否出错”而不深究错误细节的场景。

• ✅ 推荐写法：if err != nil { t.Fatal("expected no error, got:", err) }
• ✅ 反例：if err == nil { t.Fatal("expected error") } —— 易读性差，建议用 if err == nil 后接 t.Fatal 或改用 assert.Error
• ⚠️ 注意：不要忽略错误变量（如 _, _ := fn()），否则无法验证错误行为

精准匹配预定义错误值

当函数返回的是包级导出的错误变量（如 var ErrNotFound = errors.New("not found")），用 errors.Is 判断是否为同一错误实例（支持嵌套错误链）。

• ✅ 正确示例：if !errors.Is(err, ErrNotFound) { t.Errorf("expected ErrNotFound, got %v", err) }
• ✅ 更简洁（配合 testify）：assert.ErrorIs(t, err, ErrNotFound)
• ❌ 避免 err == ErrNotFound：若错误被 fmt.Errorf("wrap: %w", ErrNotFound) 包装，该比较会失败

断言错误具体类型或结构

当错误是自定义结构体（如 type ValidationError struct{ Field string }），需用 errors.As 提取底层错误并做类型断言。

• ✅ 安全提取：var ve *ValidationError; if errors.As(err, &ve) { ... }
• ✅ testify 写法：var ve *ValidationError; assert.True(t, errors.As(err, &ve))
• ⚠️ 不要直接 ve, ok := err.(*ValidationError)：若错误被包装（如 fmt.Errorf("%w", ve)），ok 为 false

校验错误消息内容（谨慎使用）

仅在错误文本本身是公共契约时（如 CLI 工具面向用户输出），才断言 err.Error() 包含特定字符串；否则应优先用 errors.Is 或 errors.As。

• ✅ 简单包含检查：if !strings.Contains(err.Error(), "timeout") { ... }
• ✅ testify：assert.Contains(t, err.Error(), "timeout")
• ❌ 避免完整字符串相等（err.Error() == "timeout"）：易受拼写/格式微调影响，脆弱
• ? 提示：可结合正则（regexp.MatchString）做更灵活匹配，但依然属于弱契约

基本上就这些。关键不是“怎么写断言”，而是“你想验证错误的哪一层契约”——是存在性、身份一致性、类型结构，还是用户可见文案。选对工具，测试才既准确又稳定。

今天关于《Golang错误断言测试技巧分享》的内容介绍就到此结束，如果有什么疑问或者建议，可以在golang学习网公众号下多多回复交流；文中若有不正之处，也希望回复留言以告知！