答案是显式检查Error值并用errors.Is和errors.As断言错误类型,避免字符串比较;为自定义错误设计结构体以便测试;使用testify等工具简化断言;覆盖空输入、边界条件和依赖失败等场景,确保错误路径下行为正确。

go 语言中测试错误处理逻辑,核心在于 显式检查 error 值是否符合预期,而不是依赖 panic 或忽略错误。Go 的错误是普通值(实现了 error 接口),所以测试时应像对待返回值一样认真对待它。
用 errors.Is 和 errors.As 断言具体错误类型或值
Go 1.13 引入的 errors.Is 和 errors.As 是判断错误本质的推荐方式,比直接比较 == 更健壮(尤其涉及包装错误时)。
-
errors.Is(err, fs.ErrNotExist):检查是否为某个已知错误(如标准库预定义错误) -
errors.As(err, &os.PathError{}):检查是否可转换为某具体错误类型,用于提取底层信息 - 避免写
if err != nil && Strings.Contains(err.Error(), "permission denied")—— 脆弱且不安全
为自定义错误设计可测试的结构
不要只靠 errors.New("xxx") 或 fmt.Errorf("xxx") 返回字符串错误。定义带字段的错误类型,并实现 Error() 方法,方便断言和复用。
- 例如:
type ValidationError Struct { Field string; Message string } - 在测试中可直接断言
v, ok := err.(*ValidationError); if ok { assert.Equal(t, "email", v.Field) } - 配合
errors.As使用更统一:var ve *ValidationError; if errors.As(err, &ve) { ... }
用 testify/assert 或 go-cmp 简化错误断言
第三方库能让错误断言更简洁、输出更友好:
立即学习“go语言免费学习笔记(深入)”;
-
assert.ErrorIs(t, err, fs.ErrNotExist)(testify) -
assert.ErrorAs(t, err, &target)(testify) - 用
cmp.Diff比较错误详情(适合调试复杂嵌套错误) - 标准库足够用,但工具能减少样板代码、提升可读性
覆盖常见错误路径:空输入、边界条件、依赖失败
错误处理测试不是“测有没有 if err != nil”,而是验证:在真实出错场景下,函数是否返回了正确的错误、是否没做不该做的事、是否释放了资源(如关闭文件)。
- 模拟 I/O 失败:用
io.ErrUnexpectedEOF、os.ErrPermission等注入错误 - 测试空切片、nil 参数、负数 ID、超长字符串等边界输入
- 对有副作用的操作(如写文件),确保错误发生时不会残留临时文件或未关闭句柄
基本上就这些。Go 的错误测试不复杂但容易忽略细节——关键是把 error 当作一等公民来验证,而不是流程里的“附带产物”。