Golang错误链式传递与信息封装示例-Golang-PHP中文网

Golang错误链式传递与信息封装示例

P粉602998670

发布： 2025-10-03 14:01:02

原创

400人浏览过

使用%w包装错误并结合errors.Is和errors.As提取，可实现链式错误传递与精准匹配，保留上下文且便于定位问题。

golang错误链式传递与信息封装示例

在Go语言中，错误处理是程序健壮性的关键部分。随着Go 1.13引入对错误包装（wrapping）的支持，以及Go 1.20进一步增强errors包的能力，开发者可以更清晰地进行错误的链式传递与信息封装。合理使用这些特性，有助于定位问题源头并保留上下文信息。

使用%w格式动词包装错误

Go通过fmt.Errorf中的%w动词实现错误包装，被包装的错误可通过errors.Unwrap提取，形成错误链。

示例如下：

package main

import (
    "errors"
    "fmt"
)

func readFile(name string) error {
    if name == "" {
        return fmt.Errorf("invalid filename: %w", errors.New("filename is empty"))
    }
    // 模拟其他错误
    return fmt.Errorf("read failed: %w", errors.New("IO error"))
}

func processFile() error {
    return readFile("")
}

func main() {
    err := processFile()
    fmt.Println("Error:", err)
    // 输出：Error: read failed: invalid filename: filename is empty
}

登录后复制

提取错误链中的原始错误

使用errors.Is和errors.As可安全比对或提取特定类型的错误，避免直接比较。

立即学习“go语言免费学习笔记（深入）”；

示例：判断是否包含某个底层错误

if errors.Is(err, os.ErrNotExist) {
    fmt.Println("File does not exist")
}

登录后复制

或提取自定义错误类型：

微信 WeLM

WeLM不是一个直接的对话机器人，而是一个补全用户输入信息的生成模型。

查看详情

var pathErr *os.PathError
if errors.As(err, &pathErr) {
    fmt.Printf("Path error: %v\n", pathErr.Path)
}

登录后复制

添加上下文而不丢失原错误

在中间层函数中，应保留原始错误以便上层处理，同时附加当前上下文。

正确做法：

func download(url string) error {
    resp, err := http.Get(url)
    if err != nil {
        return fmt.Errorf("failed to fetch %s: %w", url, err)
    }
    defer resp.Body.Close()

    if resp.StatusCode != http.StatusOK {
        return fmt.Errorf("bad status: %s: %w", resp.Status, ErrDownloadFailed)
    }
    return nil
}

登录后复制

这样调用方既能通过errors.Is检测ErrDownloadFailed，也能看到完整调用路径。

自定义错误类型结合包装

对于复杂场景，可定义携带额外信息的错误类型，并实现Unwrap方法参与错误链。

type AppError struct {
    Msg  string
    Code int
    Err  error
}

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

func (e *AppError) Unwrap() error {
    return e.Err
}

// 使用
err := &AppError{Msg: "db query failed", Code: 500, Err: sql.ErrNoRows}
wrapped := fmt.Errorf("service layer error: %w", err)

登录后复制

之后仍可用errors.Is(wrapped, sql.ErrNoRows)准确匹配。

基本上就这些。关键是用好%w、Is和As，在传递错误时既保留细节又提供上下文，让排查更高效。

以上就是Golang错误链式传递与信息封装示例的详细内容，更多请关注php中文网其它相关文章！