应使用 errors.Is 或 errors.As 判断错误类型,避免直接比较 error 字符串;封装断言函数区分“必须无错”和“必须有特定错”;注意错误链完整性、堆栈可见性及 Error() 字符串的脆弱性。
测试 error 是否为预期类型(*errors.errorString 或自定义错误)
Go 中的
是接口,直接用
比较字符串容易失效(比如多次包装、格式化差异)。更可靠的方式是用
判断是否为某个底层错误,或用
提取具体错误类型。
若函数返回
,应使用
断言,而非
若定义了自定义错误类型如
,需先用
尝试转换,再检查字段
注意:只有用
包装的错误才支持
向下穿透;
或
会切断错误链
在 test helper 函数中统一校验 error 返回
重复写
容易漏掉非空但非预期的错误。推荐封装一个断言函数,明确区分「必须无错」和「必须有特定错」两种场景。
go语言参考手册 中文CHM版
Go 是一个开源的编程语言,它能让构造简单、可靠且高效的软件变得容易。本文给大家带来Go参考手册,需要的可以来下载! Go是从2007年末由Robert Griesemer, Rob Pike, Ken Thompson主持开发,后来还加入了Ian Lance Taylor, Russ Cox等人,并最终于2009年11月开源,在2012年早些时候发布了Go 1稳定版本。现在Go的开发已经是完全开放的,并且拥有一个活跃的社区。 Go 语言特色 简洁、快速、安全 并行、有趣、开源 内存管理、v数组安全、编译
下载
对「应成功」路径:写
,内部用
对「应失败」路径:写
或
避免在 helper 里用
后再调
—— 这会导致报错行号指向 helper 内部,掩盖真实调用位置;改用
并手动加前缀更清晰
用 testify/assert 或 go-cmp 验证 error 的结构与消息
当需要比对错误消息内容(比如日志、用户提示),且确认该消息是稳定 API 的一部分时,可做字符串匹配,但要控制粒度。
用
比全等更健壮,避免因空格、标点微调导致测试脆性
若错误实现了
或含字段(如
),用
深度比对结构体字段,而不是只看
输出
不建议在生产代码中依赖
做逻辑分支 —— 测试里也不该强化这种用法;优先走
/
路线
测试 error 的关键不在“有没有错”,而在于“错得是否精准”。最容易被忽略的是错误链断裂(没用
)、helper 函数吞掉真实堆栈、以及把
字符串当作契约来断言 —— 这三处一松动,错误处理测试就形同虚设。
error==errors.Iserrors.Asfmt.Errorf("failed: %w", io.EOF)errors.Is(err, io.EOF)err.Error() == "failed: EOF"type ValidationError struct{ Msg string }errors.As(err, &target)%werrors.Is%sfmt.Sprintfif err != nil { t.Fatal(err) }mustNoError(t, err)if err != nil { t.Fatalf("expected no error, got: %v", err) }mustErrorIs(t, err, io.EOF)mustErrorAs(t, err, &validationErr)t.Helper()t.Fatalt.Fatalfassert.Contains(t, err.Error(), "invalid ID")Unwrap() errorHTTPStatus intcmp.EqualError()err.Error()errors.IsAsfunc TestFetchUser_ErrorCases(t *testing.T) {
t.Run("not found returns ErrUserNotFound", func(t *testing.T) {
client := &mockHTTPClient{status: 404}
_, err := FetchUser(context.Background(), client, "123")
var notFoundErr *UserNotFoundError
if !errors.As(err, ¬FoundErr) {
t.Fatalf("expected *UserNotFoundError, got %T: %v", err, err)
}
if notFoundErr.ID != "123" {
t.Errorf("expected ID '123', got %q", notFoundErr.ID)
}
})
}%wError()