Go中测试错误需检查类型、内容及清理:用errors.As/errors.Is断言错误类型,strings.Contains验证关键错误消息,mock依赖模拟各类错误场景,并确保错误路径下资源正确清理。

在 Go 中测试错误返回,核心是检查函数是否按预期返回特定错误(包括类型、内容或自定义错误码),而不是只判断 err != nil。
断言错误是否非空且类型正确
很多函数返回 error 接口,但实际可能是自定义错误类型(如 os.PathError、fmt.Errorf 或实现 error 的结构体)。用类型断言或 errors.As 检查更可靠:
- 使用
errors.As(err, &target)判断是否为某具体错误类型(推荐,支持嵌套错误) - 用
errors.Is(err, targetErr)判断是否等于某个已知错误值(如io.EOF) - 避免直接用
reflect.TypeOf(err) == reflect.TypeOf(&MyError{}),它不处理包装错误
验证错误消息是否符合预期
仅检查错误类型不够,有时需确认错误提示内容(比如用户可见的提示、日志上下文)。可用 strings.Contains(err.Error(), "xxx") 或正则匹配,但注意:
- 不要过度依赖完整字符串——错误消息可能随版本变化;优先匹配关键子串(如
"permission denied") - 若错误由
fmt.Errorf("failed to open %s: %w", path, err)包装,用errors.Unwrap或errors.Is更稳妥 - 对自定义错误类型,建议提供可导出的方法(如
.Code()或.Reason())供测试断言,而非解析Error()字符串
模拟不同错误场景进行边界测试
真实错误往往来自底层依赖(如文件系统、网络、数据库)。测试时应主动注入各类错误,验证函数能否正确传播、转换或处理:
立即学习“go语言免费学习笔记(深入)”;
- 用接口抽象依赖(如定义
Reader接口代替直接用os.File),在测试中传入返回预设错误的 mock 实现 - 测试常见错误组合:空输入、权限不足、路径不存在、超时、连接中断、JSON 解析失败等
- 对返回多个错误的函数(如同时返回
err和validationErr),明确每个错误的触发条件和优先级
测试错误路径的副作用是否被正确清理
有状态操作(如创建临时文件、获取锁、开启事务)在出错时必须确保资源释放或回滚。测试时需验证:
- 错误发生后,临时文件是否被删除、锁是否释放、连接是否关闭
- 可借助
defer+ 计数器、或 patch 全局函数(如用os.Remove替换为记录调用的 stub)来观测清理行为 - 使用
testify/assert或原生testing.T.Cleanup辅助验证终态(例如:测试结束后检查目标目录是否为空)










