Go 中更简洁的错误处理实践

Go 中更简洁的错误处理实践第1张

本文介绍如何通过封装错误状态、利用 go 的“错误即值”特性，减少重复的 if-err != nil 检查，使核心逻辑更清晰、错误处理更统一。

在 Go 开发中，频繁的错误检查（如 if err != nil { ... return }）虽符合语言哲学，但若大量堆砌在业务逻辑中，会导致代码冗长、可读性下降，甚至掩盖真正的数据流意图。幸运的是，Go 并不要求每个错误都就地展开处理——错误是值，可被封装、传递、延迟检查、批量聚合。关键不在于跳过检查，而在于让检查更优雅、更结构化。

✅ 推荐方案：使用状态封装器（如 errWriter）

最经典且实用的模式之一，是定义一个携带错误状态的包装类型。以 errWriter 为例：

type errWriter struct {
    w   io.Writer
    err error
}

func (ew *errWriter) write(buf []byte) {
    if ew.err != nil {
        return // 已出错，跳过后续写入
    }
    _, ew.err = ew.w.Write(buf)
}

func (ew *errWriter) Error() error { return ew.err }

该类型将「写操作」与「错误累积」解耦：调用方只需连续调用 ew.write()，无需每步判错；最终统一检查 ew.Error() 即可：

ew := &errWriter{w: os.Stdout}
ew.write([]byte("Hello, "))
ew.write([]byte("world"))
ew.write([]byte("!"))
if ew.err != nil {
    log.Fatalf("write failed: %v", ew.err)
}

? 同理，你可轻松扩展出 errScanner（用于 Scan 链式调用）、errCloser（自动 defer Close + 记录首次 close 错误）等，按需抽象。

✅ 进阶技巧：错误链与统一处理器

若希望全局统一错误日志与终止行为（如问题中提到的 log.Fatalf），可定义一个轻量级错误处理器：

type ErrorHandler struct {
    fatal func(msg string, args ...any)
}

func NewErrorHandler(fatalFunc func(string, ...any)) *ErrorHandler {
    return &ErrorHandler{fatal: fatalFunc}
}

func (h *ErrorHandler) Check(err error, context string) {
    if err != nil {
        h.fatal("%s: %v", context, err)
    }
}

// 使用方式：
eh := NewErrorHandler(log.Fatalf)
eh.Check(result.Scan(&bot.BID, &bot.LANGUAGE, &bot.SOURCE), "result.Scan")
fileName, err := copySourceToTemporaryFile(bot)
eh.Check(err, "copySourceToTemporaryFile")

⚠️ 注意：log.Fatalf 会直接终止进程，仅适用于 CLI 工具或启动阶段不可恢复的错误；Web 服务或长期运行程序应改用 return err 或 http.Error 等上下文感知方式。