Go语言错误处理技巧大全

Go语言摒弃传统异常机制，以显式返回和检查error为核心构建清晰可控的错误处理体系：通过基础的err非nil判断确保每个失败路径都被主动处理；利用fmt.Errorf配合%w包装错误以保留完整错误链，便于后续用errors.Is或errors.As精准识别与断言；支持定义实现error接口的自定义结构体（如含Code、Message字段）来携带业务上下文，适配HTTP状态码等场景；并在极少数无法避免的panic场景下，谨慎使用defer+recover将其安全转化为普通错误。这四大方法协同作用，让Go程序在保持简洁性的同时具备高度健壮性与可维护性。

Go语言中错误处理的核心是显式处理错误，不依赖异常机制。函数通过返回error类型来表示失败，调用者必须主动检查并处理。以下是常见的错误处理方式。

直接返回并检查error

这是最基础也是最常用的错误处理方式。函数执行可能出错的操作后，返回一个error值，调用方通过判断是否为nil来决定后续逻辑。

示例：

func readFile(filename string) ([]byte, error) {
    data, err := os.ReadFile(filename)
    if err != nil {
        return nil, err
    }
    return data, nil
}

// 调用时
data, err := readFile("config.json")
if err != nil {
    log.Fatal("读取文件失败:", err)
}

关键点：每个可能出错的操作都应检查err，避免忽略错误导致程序行为异常。

包装并增强错误信息

从Go 1.13开始，支持使用%w格式化动词包装错误，保留原始错误链，便于排查问题根源。

示例：

if err != nil {
    return fmt.Errorf("解析配置失败: %w", err)
}

之后可以用errors.Is和errors.As进行错误比较或类型断言：

if errors.Is(err, os.ErrNotExist) {
    // 处理文件不存在
}
if target := &MyCustomError{}; errors.As(err, target) {
    // 处理特定类型的错误
}

自定义错误类型

当需要携带额外上下文（如状态码、重试建议等）时，可以定义实现了error接口的结构体。

示例：

type AppError struct {
    Code    int
    Message string
    Err     error
}

func (e *AppError) Error() string {
    return fmt.Sprintf("[%d] %s: %v", e.Code, e.Message, e.Err)
}

// 使用
return &AppError{Code: 400, Message: "参数无效", Err: err}

这样可以在上层根据Code做不同处理，比如HTTP响应状态码映射。

延迟恢复（defer + recover）用于panic场景

虽然Go推荐用error而非panic控制流程，但在某些库或不可恢复场景中仍可能触发panic。可通过defer结合recover捕获并转为普通错误。

示例：

defer func() {
    if r := recover(); r != nil {
        err = fmt.Errorf("发生panic: %v", r)
    }
}()

注意：这种方式应谨慎使用，仅适用于无法避免的panic场景，比如第三方库调用或初始化阶段。

基本上就这些。Go的错误处理强调清晰和可控，不隐藏失败路径。合理使用error返回、包装、自定义类型和recover机制，能写出健壮的服务代码。

终于介绍完啦！小伙伴们，这篇关于《Go语言错误处理技巧大全》的介绍应该让你收获多多了吧！欢迎大家收藏或分享给更多需要学习的朋友吧~golang学习网公众号也会发布Golang相关知识，快来关注吧！