Golang错误处理技巧：error返回与异常判断

Go语言的错误处理摒弃了传统try-catch异常机制，转而将错误视为普通值，强调“出错是常态、需显式应对”的务实哲学：函数统一将error作为最后一个返回值，调用方必须主动用if err != nil进行检查，避免静默失败；推荐使用fmt.Errorf搭配%w包装错误以构建可追溯的错误链，并借助errors.Is和errors.As精准识别和提取底层错误；对于复杂场景，还可自定义error类型注入上下文信息，实现结构化、可诊断、易追踪的健壮错误处理——掌握这些技巧，你就能写出更清晰、更可靠、更符合Go精神的代码。

Go 语言的错误处理不依赖 try-catch，而是通过函数显式返回 error 类型值，并由调用方主动检查。这是 Go 的核心设计哲学：错误是普通值，不是异常；出错是常态，不是意外。

函数返回 error 的标准写法

Go 中约定俗成的错误返回模式是：最后一个返回值为 error 类型。如果操作成功，返回 nil；失败则返回具体错误（如 fmt.Errorf、errors.New 或系统错误）。

例如：

func divide(a, b float64) (float64, error) {
    if b == 0 {
        return 0, fmt.Errorf("division by zero")
    }
    return a / b, nil
}

调用时必须检查 error：

result, err := divide(10, 0)
if err != nil {
    log.Printf("计算失败：%v", err)
    return
}
fmt.Println("结果：", result)

判断 error 是否发生：永远先检查 err != nil

Go 不会自动中断执行，也不抛出异常。一旦忽略 err，程序可能继续用无效数据运行，导致更隐蔽的问题。

• 不要只写 if err { ... } —— error 是接口类型，不能直接布尔判断
• 正确写法始终是 if err != nil { ... }
• 常见误写：if err == nil { ... } else { ... } —— 可读性差，建议把错误处理提前（“fail fast”）

创建和包装错误的常用方式

Go 1.13+ 推荐使用 fmt.Errorf 配合 %w 动词包装底层错误，便于后续用 errors.Is 或 errors.As 判断：

// 包装错误（保留原始错误链）
err := fmt.Errorf("reading config: %w", os.OpenError)

// 检查是否是特定错误
if errors.Is(err, os.ErrNotExist) {
    log.Println("配置文件不存在，使用默认配置")
}

// 提取底层错误类型
var pathErr *os.PathError
if errors.As(err, &pathErr) {
    log.Printf("路径错误：%s", pathErr.Path)
}

自定义错误类型（可选但推荐用于关键逻辑）

当需要携带额外上下文（如错误码、请求 ID、重试次数），可实现 error 接口：

type MyError struct {
    Code int
    Msg  string
    ReqID string
}

func (e *MyError) Error() string {
    return fmt.Sprintf("[%d] %s (req=%s)", e.Code, e.Msg, e.ReqID)
}

// 使用
return nil, &MyError{Code: 400, Msg: "invalid input", ReqID: r.Header.Get("X-Request-ID")}

这样既保持兼容性，又支持结构化错误处理和日志追踪。

文中关于的知识介绍，希望对你的学习有所帮助！若是受益匪浅，那就动动鼠标收藏这篇《Golang错误处理技巧：error返回与异常判断》文章吧，也可关注golang学习网公众号了解相关技术文章。