如何在 Go 中正确进行错误的单元测试-Golang-PHP中文网

如何在 Go 中正确进行错误的单元测试

Go 单元测试中应优先检查错误是否为 nil，避免依赖错误字符串；推荐使用自定义错误类型配合 errors.Is 进行语义化断言，提升测试健壮性与可维护性。

go 单元测试中应优先检查错误是否为 nil，避免依赖错误字符串；推荐使用自定义错误类型配合 `errors.is` 进行语义化断言，提升测试健壮性与可维护性。

在 Go 的单元测试中，对返回 error 类型的函数进行验证，核心原则是：关注错误的语义，而非其字符串表现。简单地用 if err != nil 判断虽能覆盖基础场景，但往往不足以表达业务逻辑中的错误分类；而直接比对 err.Error() 字符串则极易因日志优化、翻译或格式调整导致测试脆弱——这违背了“错误消息面向用户，错误类型面向程序”的设计哲学。

✅ 推荐做法分三步演进：

基础层：非空检查（适用于多数场景）

func TestDivide_ValidInput(t *testing.T) {
    result, err := Divide(10, 2)
    if err != nil {
        t.Fatalf("expected no error, got %v", err)
    }
    if result != 5 {
        t.Errorf("expected 5, got %v", result)
    }
}

语义层：使用 errors.Is 匹配预定义错误（Go 1.13+ 标准实践）
先定义可识别的错误变量：

var (
    ErrDivideByZero = errors.New("division by zero")
)

func Divide(a, b int) (int, error) {
    if b == 0 {
        return 0, ErrDivideByZero
    }
    return a / b, nil
}

测试时精准断言错误种类：

Golang Spf13 Viper

Go 配置库，使用 spf13/viper — 分层优先级（flag > env >file > KV > default），提供 BindPFlag/BindPFlags、SetEnvPrefix + SetEnvKeyReplace 等功能。

下载

func TestDivide_ByZero(t *testing.T) {
    _, err := Divide(5, 0)
    if !errors.Is(err, ErrDivideByZero) {
        t.Errorf("expected ErrDivideByZero, got %v", err)
    }
}

结构层：自定义错误类型（需携带上下文或状态）
当需验证错误细节（如 HTTP 状态码、重试次数）时，实现带字段的错误：

type ValidationError struct {
    Field string
    Code  int
}
func (e *ValidationError) Error() string {
    return fmt.Sprintf("validation failed on %s (code: %d)", e.Field, e.Code)
}
// 在测试中直接访问字段
if ve, ok := err.(*ValidationError); ok && ve.Field == "email" && ve.Code == 400 {
    // ✅ 断言通过
}

⚠️ 注意事项：