Go中错误处理如何写单元测试_Go错误测试技巧总结

冬敏君_2190

冬敏君_2190

2026-01-14

517人浏览

原创

errors.Is和errors.As用于精准断言包装错误:errors.Is(err, ErrNotFound)判断是否为某哨兵错误(含任意包装层),errors.As(err, &target)提取并断言是否实现某接口。

go中错误处理如何写单元测试_go错误测试技巧总结

如何用 errors.Is 和 errors.As 断言特定错误

Go 1.13 引入的 errors.Is 和 errors.As 是测试自定义错误类型的核心工具。直接比较 == 会失败,因为包装后的错误(如 fmt.Errorf("wrap: %w", err))地址不同。

常见错误现象:断言 err == myErr 总是 false,即使错误语义相同;或用 strings.Contains(err.Error(), "xxx") 做模糊匹配,导致测试脆弱、易误报。

  • errors.Is(err, ErrNotFound) 用于判断是否为某个哨兵错误(或其任意包装层)
  • errors.As(err, &target) 用于提取并断言错误是否实现了某接口(如 *os.PathError)
  • 测试前确保被测函数返回的是你定义的哨兵错误或实现了目标接口的错误类型
func TestFetchUser_ErrorNotFound(t *testing.T) {
    err := FetchUser(999)
    if !errors.Is(err, ErrNotFound) {
        t.Fatalf("expected ErrNotFound, got %v", err)
    }
}

func TestOpenFile_ErrorPath(t *testing.T) {
    err := os.Open("/nonexistent/file.txt")
    var pathErr *os.PathError
    if !errors.As(err, &pathErr) {
        t.Fatal("expected *os.PathError")
    }
    if pathErr.Op != "open" {
        t.Errorf("expected op 'open', got %q", pathErr.Op)
    }
}

如何模拟并验证错误路径是否被正确执行

单元测试中要覆盖错误分支,关键不是“让函数出错”,而是“让依赖返回错误”,然后验证主逻辑是否按预期处理(比如是否提前返回、是否记录日志、是否重试等)。

使用场景:HTTP 客户端、数据库查询、文件操作等外部依赖出错时的控制流。

  • 不要在测试里真实调用 os.Open 或 http.Get,而是通过接口抽象 + 依赖注入
  • 给被测函数传入一个返回预设错误的 mock 实现(例如 func() ([]byte, error) { return nil, io.EOF })
  • 检查返回值是否为预期错误,同时检查副作用(如是否调用了日志函数、是否设置了状态字段)
type FileReader interface {
    ReadFile(name string) ([]byte, error)
}

func ProcessConfig(r FileReader, name string) error {
    data, err := r.ReadFile(name)
    if err != nil {
        log.Printf("failed to read %s: %v", name, err)
        return fmt.Errorf("config load failed: %w", err)
    }
    // ... process
    return nil
}

func TestProcessConfig_ReadError(t *testing.T) {
    mockReader := &mockFileReader{err: os.ErrNotExist}
    err := ProcessConfig(mockReader, "config.json")
    if !errors.Is(err, os.ErrNotExist) && !strings.Contains(err.Error(), "config load failed") {
        t.Fatal("expected wrapped error with 'config load failed'")
    }
    // 还可检查 mockReader.logCalls 是否被触发(若需验证日志)
}

为什么 t.Error 比 panic 更适合错误路径测试

新手常在错误分支里写 if err != nil { panic(err) } 来“快速失败”,但这会让测试中途崩溃,无法继续执行后续断言,也掩盖了错误处理逻辑本身是否正确。

JSON Toolkit
JSON Toolkit

JSON文件多功能工具。支持格式化、验证、压缩、键排序及点记法路径查询。零依赖。

下载

性能与可维护性影响:panic 触发堆栈捕获,开销大;且一旦 panic,该测试函数立即终止,无法得知其他分支是否也出问题。

  • 用 t.Errorf 或 t.Fatalf 显式报告失败,保持测试可控
  • t.Fatalf 适用于“前置条件不满足”(如 setup 失败),而非业务错误
  • 业务错误必须作为返回值参与断言,这是 Go 错误处理契约的一部分

容易忽略的边界:nil 错误 vs 空错误字符串 vs 自定义零值错误

测试时最容易漏掉的是对 nil 错误的显式校验,尤其当函数文档没说清“成功时是否保证返回 nil”时。

常见陷阱:把 err != nil 当作“有错误”,但某些库(如 json.Unmarshal)在输入为空字节时返回 nil,而另一些函数可能返回 &MyErr{Msg: ""} —— 它非 nil,但 err.Error() 是空字符串。

  • 永远优先用 if err != nil 判断,而不是 if err.Error() != ""
  • 若自定义错误类型有零值(如 type MyErr struct{ Code int }),确保其实现了 Error() string 并在 Code == 0 时返回有意义内容,或明确禁止零值构造
  • 在测试中补全 nil 分支:既测“有错”,也测“没错”,尤其涉及缓存、短路逻辑时

复杂点在于:错误是否被多次包装、是否跨 goroutine 传播、是否在 defer 中被覆盖——这些都会让 errors.Is 失效或行为难预测。动手前先确认错误链是否干净。

相关文章

PHP速学视频免费教程(入门到精通)
PHP速学视频免费教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

相关标签:

js json 字节

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
json数据格式
json数据格式

JSON是一种轻量级的数据交换格式。本专题为大家带来json数据格式相关文章,帮助大家解决问题。

2023.08.07

2355

5

json是什么
json是什么

JSON是一种轻量级的数据交换格式,具有简洁、易读、跨平台和语言的特点,JSON数据是通过键值对的方式进行组织,其中键是字符串,值可以是字符串、数值、布尔值、数组、对象或者null,在Web开发、数据交换和配置文件等方面得到广泛应用。本专题为大家提供json相关的文章、下载、课程内容,供大家免费下载体验。

2023.08.23

3882

1

jquery怎么操作json
jquery怎么操作json

操作的方法有:1、“$.parseJSON(jsonString)”2、“$.getJSON(url, data, success)”;3、“$.each(obj, callback)”;4、“$.ajax()”。更多jquery怎么操作json的详细内容,可以访问本专题下面的文章。

2023.10.13

1296

3

go语言处理json数据方法
go语言处理json数据方法

本专题整合了go语言中处理json数据方法,阅读专题下面的文章了解更多详细内容。

2025.09.10

4519

7

string转int
string转int

在编程中,我们经常会遇到需要将字符串(str)转换为整数(int)的情况。这可能是因为我们需要对字符串进行数值计算,或者需要将用户输入的字符串转换为整数进行处理。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

2023.08.02

7599

3

scripterror怎么解决
scripterror怎么解决

scripterror的解决办法有检查语法、文件路径、检查网络连接、浏览器兼容性、使用try-catch语句、使用开发者工具进行调试、更新浏览器和JavaScript库或寻求专业帮助等。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

2023.10.18

1089

5

500error怎么解决
500error怎么解决

500error的解决办法有检查服务器日志、检查代码、检查服务器配置、更新软件版本、重新启动服务、调试代码和寻求帮助等。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

2023.10.25

3560

5

js 字符串转数组
js 字符串转数组

js字符串转数组的方法:1、使用“split()”方法;2、使用“Array.from()”方法;3、使用for循环遍历;4、使用“Array.split()”方法。本专题为大家提供js字符串转数组的相关的文章、下载、课程内容,供大家免费下载体验。

2023.08.03

1938

5

js截取字符串的方法
js截取字符串的方法

js截取字符串的方法有substring()方法、substr()方法、slice()方法、split()方法和slice()方法。本专题为大家提供字符串相关的文章、下载、课程内容,供大家免费下载体验。

2023.09.04

3224

5

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
WEB前端教程【HTML5+CSS3+JS】
WEB前端教程【HTML5+CSS3+JS】

共101课时 | 21.4万人学习

JS进阶与BootStrap学习
JS进阶与BootStrap学习

共39课时 | 4.9万人学习