Golang错误处理技巧分享

Go语言的错误处理没有捷径，真正的“优雅”源于坚守三个铁律：绝不跳过if err != nil的检查、绝不依赖脆弱的字符串匹配判断错误、绝不丢弃原始错误——只有通过%w正确包装、合理定义可识别的自定义错误类型，并善用errors.Is和errors.As进行语义化判断，才能构建出完整可追溯的错误链；一旦在任意环节松懈（如忽略Close()错误、滥用字符串拼接、过度包装或遗漏嵌入原始err），诊断线索就会断裂，让后续的调试沦为盲人摸象。

Go 里没有“优雅错误处理”的魔法开关，只有不跳过 if err != nil、不用字符串匹配错误、不丢掉原始 err 这三件事做对了，错误链才不会断、问题才查得快。

为什么不能跳过 if err != nil

Go 不会替你中断逻辑。写 json.Unmarshal(data, &v) 却不检查 err，v 很可能没被赋值，后续访问直接 panic；调 os.Open("config.yaml") 忽略错误，程序就带着 nil *os.File 继续往下跑——而编译器完全不管。

• 常见现象：用 _, err := doSomething() 丢掉第一个返回值，结果关键数据丢了，错误还查不出上下文
• 初始化阶段（如 main 开头）可用 log.Fatal，但服务运行中必须返回 error，由上层决定重试、降级或返回 HTTP 状态码
• 循环里只 log.Printf 却不 return 或 break，比如批量读文件时一个失败，其余全被静默跳过

fmt.Errorf 里的 %w 到底怎么用

不用 %w，等于主动切断错误链。用 fmt.Errorf("loading config: %v", err) 或拼接字符串，原始错误类型（比如 os.ErrNotExist）就没了，errors.Is(err, os.ErrNotExist) 永远返回 false。

• 正确写法：return fmt.Errorf("loading config: %w", err)——保留底层错误的所有能力
• 包装层级不宜过深：同一错误被 %w 包装超过 3 层，调试时容易迷失；优先在模块边界（如函数出口、HTTP handler 入口）包装一次，补充语义即可
• 别滥用堆栈：中间层包装不必加堆栈；需要堆栈线索时，只在最外层用第三方库（如 github.com/pkg/errors）或 Go 1.22+ 的 errors.AddStack

什么时候该定义自定义错误类型

当错误需要携带结构化字段（比如 Code、Field、Retryable），或者要被其他模块精确识别并分支处理时，就不能只靠 fmt.Errorf 返回字符串了。

• 推荐结构：type ValidationError struct { Field string; Code string; Err error }，并在 Error() 方法里组合输出
• 必须嵌入 Err error 字段：否则 errors.As 提取不到原始 I/O 错误，errors.Is 也判不了 os.ErrNotExist
• HTTP 服务中可据此映射状态码：if errors.As(err, &validationErr) { http.Error(w, validationErr.Msg, http.StatusBadRequest) }
• 避免只存字符串：Msg string 而不存 Err error，等于把诊断线索全删了

errors.Is 和 errors.As 为什么不能用字符串匹配代替

用 strings.Contains(err.Error(), "timeout") 判断超时，既脆弱又难维护：日志格式一变、翻译一换、空格一多，整个判断就失效。

• errors.Is(err, fs.ErrNotExist) 判断是否为某类预定义错误；errors.As(err, &pathErr) 尝试将错误解包并赋值给具体类型变量，比类型断言更安全（能穿透多层包装）
• 只有用 %w 包装的错误才可被 errors.Is/errors.As 正确识别
• 标准库中的 I/O 错误（如 os.PathError）、网络错误（如 net.OpError）都支持这些操作
• 避免在中间层无意义地重 wrap：比如 return fmt.Errorf("read config: %w", err) 合理，但 return fmt.Errorf("failed: %w", err) 无信息增量

最容易被忽略的是：错误不是日志，也不是提示语；它是可诊断的上下文容器。只要漏掉一次 %w、少判一层 errors.Is、在 defer f.Close() 里不检查错误，整条链就断了——你下次 debug 时，面对的就只剩一个空泛的 “something failed”。

好了，本文到此结束，带大家了解了《Golang错误处理技巧分享》，希望本文对你有所帮助！关注golang学习网公众号，给大家分享更多Golang知识！