Go 错误处理核心是显式返回 error 接口值,调用方必须主动检查;常用 errors.New、fmt.Errorf(推荐 %w 包装),支持 errors.Is/As 判断类型,避免暴露内部错误细节。

Go 语言中错误处理的核心是 显式返回 error 类型值,不依赖异常机制。函数通过多返回值(通常最后一个)返回 error,调用方必须主动检查,这是 Go 的设计哲学——“错误是值,不是例外”。
error 是接口,最常用的是 errors.New 和 fmt.Errorf
Go 内置的 error 是一个接口:type error interface { Error() string }。
你只需实现这个方法,就能成为合法 error。但绝大多数场景用标准库就够了:
-
errors.New("something went wrong")—— 简单字符串错误 -
fmt.Errorf("failed to open %s: %w", filename, err)—— 带格式化 + 错误链(推荐用%w包装底层错误) - 自定义 error 类型适合需要携带额外字段(如状态码、重试建议)时,例如实现
TimeoutError并加Timeout() bool方法
必须检查 error,且通常优先处理
Go 不强制你写 if err != nil,但忽略它等于埋雷。惯用写法是“失败即返回”,让正常逻辑缩进最小化:
- ✅ 推荐:
if err != nil { return err }或return nil, err - ❌ 避免:
if err == nil { /* 正常逻辑一大段 */ }—— 嵌套深,易漏错 - 注意:
defer中的函数不会自动获取主函数的err变量,需显式传参或闭包捕获
区分错误类型:用 errors.Is 和 errors.As
不要用 == 或 strings.Contains(err.Error(), "...") 判断错误种类,它们脆弱且无法穿透错误链:
立即学习“go语言免费学习笔记(深入)”;
-
errors.Is(err, fs.ErrNotExist)—— 判断是否为某类底层错误(支持%w链) -
var e *os.PathError; if errors.As(err, &e) { ... }—— 尝试提取具体错误类型,用于访问其字段 - 自定义 error 实现
Is()或As()方法可增强语义(比如网络超时 error 主动声明Is(timeoutErr))
不暴露内部错误细节给上层或用户
底层 error(如数据库驱动错误、系统调用错误)通常含敏感路径或内部结构,不应直接返回给 API 调用方或日志公开:
- 对外返回新 error:
fmt.Errorf("failed to save user: %w", dbErr),再用errors.Unwrap或日志中间件记录原始错误 - HTTP handler 中,用
http.Error(w, "Internal server error", http.StatusInternalServerError),而非把dbErr.Error()直接吐给前端 - 调试时可用
fmt.Printf("%+v", err)查看完整错误链和栈帧(需用github.com/pkg/errors或 Go 1.13+ 原生支持)
基本上就这些。Golang 的 error 处理不复杂但容易忽略边界,关键是养成“每次调用后立刻问一句:这里可能出错吗?”的习惯。










