Go 错误处理实践总结示例

Go 错误处理实践总结示例

目录

前言

Go 错误处理机制

Go 内置 errors

Error 与 Exception

Go 错误处理最佳实践

panic

error

总结

前言

最近在对极客时间毛剑老师的 Go 进阶训练营进行重温和学习汇总,这是一门比较偏向于工程化以及原理层面的的课程,涵盖的知识点非常多,因此决定开一个系列来进行记录,也便于自己总结查阅。

Go 错误处理机制 Go 内置 errors

Go 语言中的 error 就是普通的一个接口,表示值

// http://golang.org/pkg/builtin/#error // error 接口的定义 type error interface { Error() string } // http://golang.org/pkg/errors/error.go // errors 构建 error 对象 type errorString struct { s string } func (e *errorString) Error() string { return e.s }

基础库中有大量自定义的 error,如 Error: EOF,而 errors.New() 返回的是内部 errorString 对象的指针。

Error 与 Exception

不同于 Java、C++ 等语言,Go 处理异常的逻辑是不引入 exception,而是采取多参数返回,因此可以在函数中带入 error interface 对象来交给调用者来进行处理。

func handle() (int, error) { return 1, nil } func main() { i, err := handle() if err != nil { return } // 其他处理逻辑 }

需要注意的是,Go 中有 panic 的机制,可以和 recovery 搭配实现类似于 try...exception... 的效果,但是 Go 中的 panic 并不等同于 exception,exception 一般是交由调用者来进行处理,而 Go panic 则是针对真正异常的情况(如索引越界、栈溢出、不可恢复的环境问题等),意味着代码不能继续运行,而不能假设调用者会来解决 panic。

Go 的多返回值来支持调用者进行错误处理的方式给予了开发者很大的灵活性,有如下优势

简单

Plan for failure, not success

没有隐藏的控制流

完全交给开发者来控制 error

error 是值,因此有很大的灵活性进行处理

Go 错误处理最佳实践 panic

panic 只用于真正异常的情况,如

在程序启动的时候,如果有强依赖的服务出现故障时 panic 退出

在程序启动的时候,如果发现有配置明显不符合要求, 可以 panic 退出(防御编程)

在程序入口处,例如 gin 中间件需要使用 recovery 预防 panic 程序退出

因为 panic 会导致程序直接退出,而如果使用 recovery 进行处理的话性能不好且不可控。因此,其他情况下只要不是不可恢复的程序错误,都不应该直接 panic 应该返回 error,从而交给开发者。

error

一般我们在开发中会使用 github.com/pkg/errors 处理应用错误,但需要注意的是,在公共库当中,我们一般不使用。

在通过多返回值来判断错误时,error 应该是函数的最后一个返回值,而当 error 不是 nil 时,其他返回值均应该为不可用状态,不应该对它们进行额外处理,错误处理的时候也应该先判断错误,当 if err != nil 时及时返回错误,从而避免过多的代码嵌套。

// 错误示例 func f() error { ans, err := someFunc() if err == nil { // 其他逻辑 } return err } // 正确示例 func f() error { ans, err := someFunc() if err != nil { return err } // 其他逻辑 return nil }

当程序出现错误时,一般使用 errors.New 或 errors.Errorf 返回错误值

func someFunc() error { res := anotherFunc() if res != true { errors.Errorf("结果错误,已尝试 %d 次", count) } // 其他逻辑 return nil }

而如果是调用其他函数出现问题,则应该直接返回,如果需要携带额外信息,则使用 errors.WithMessage

func someFunc() error { res, err := anotherFunc() if err != nil { return errors.WithMessage(err, "other information") } }

如果是调用其他库(标准库、企业公共库、开源第三方库等)获取到错误时,请使用 errors.Wrap 添加堆栈信息。只需要在错误第一次出现时使用,且在基础库和被大量引用的第三方库编写时一般不使用,避免堆栈信息重复。

func f() error { err := json.Unmashal(&a, data) if err != nil { return errors.Wrap(err, "other information") } // 其他逻辑 return nil }

当需要对错误进行判断时,需要采用 errors.Is 进行比较

func f() error { err := A() if errors.Is(err, io.EOF){ return nil } // 其他逻辑 return nil }

而对错误类型进行判断时则使用 errors.As 进行赋值

func f() error { err := A() var errA errorA if errors.As(err, &errA){ // ... } // 其他逻辑 return nil }

对于业务中的错误(如输入错误等),最好在统一的一个地方建立自己的错误字典,其中应该包含错误代码并且可以在日志中作为独立字段打印,也需要有清晰的文档。

我们常常用日志来辅助我们进行错误处理,不需要进行返回、被忽略的错误必须输出日志,但禁止每个出错的地方都打日志。而如果同一个地方不停地报错,最好是打印一次错误详情并打印出现次数。

总结

以上就是对 Go 错误处理和最佳实践的一些总结,后续也会对错误类型、错误包装以及常见的使用中遇到的坑等进行总结。

参考 golang gorm错误处理事务以及日志用法示例

更多关于Go 错误处理的资料请关注易知道(ezd.cc)其它相关文章!

推荐阅读

    电脑硬盘csgo凭空消失|csgo突然消失

    电脑硬盘csgo凭空消失|csgo突然消失,,1. csgo突然消失可能是系统出现卡顿,刷新一下重启试试2. csgo地图突然消失方法如下:1、在电脑中启动cs

    csgo参数设置|csgo怎么保存

    csgo参数设置|csgo怎么保存,,csgo怎么保存第一步下载csgo的官方版本。然后再下载一个5e对战平台,PS:5e的账号和csgo的账号不是一个账号。第

    aigo无线硬盘连电脑|aigo优盘连接手机

    aigo无线硬盘连电脑|aigo优盘连接手机,,1. aigo优盘连接手机不管是爱国者U盘还是其他的U盘,要导入华为手机的话,首先需要有一个转接头,一头插

    csgo高手快捷键|csgo快捷键指令

    csgo高手快捷键|csgo快捷键指令,,1. csgo快捷键指令反恐精英全球攻势游戏中,死亡竞赛的回合时间60分钟:mp_roundtime 60,休闲/竞技模式的每局

    aigo电脑主机系统重启|csgo重启电脑

    aigo电脑主机系统重启|csgo重启电脑,,csgo重启电脑如果重启成功应该是不需要,相反就需重新安装csgo重启电脑重连不上直接打开游戏,通过游戏

    csgo电脑等级|csgo电脑等级指令

    csgo电脑等级|csgo电脑等级指令,,csgo电脑等级指令如图:竞技匹配等级另外还有每打一局都加经验的那个等级是满级为40,满了之后可兑换赛季纪

    csgo设置准星|csgo设置准星大小

    csgo设置准星|csgo设置准星大小,,csgo设置准星大小csgo怎么设置准星方法:1.打开CSGO游戏,打开创意工坊,查找crashz' Crosshair Generator v2

    duolingo电脑版|Duolingo软件

    duolingo电脑版|Duolingo软件,,Duolingo软件1.百词斩:2.英语流利说:“英语流利说”是一款融合创新口语教学理念和尖端语音评估技术的英语口