如何在 Go 中正确识别和处理不同类型的错误（包括自定义错误与标准库错误）-Golang-PHP中文网

如何在 Go 中正确识别和处理不同类型的错误（包括自定义错误与标准库错误）

Go 中错误处理不应依赖字符串匹配，而应通过类型断言、错误值比较或自定义错误类型进行精准识别；本文详解 switch 分支、err.(type) 类型断言及封装错误信息的最佳实践。

go 中错误处理不应依赖字符串匹配，而应通过类型断言、错误值比较或自定义错误类型进行精准识别；本文详解 `switch` 分支、`err.(type)` 类型断言及封装错误信息的最佳实践。

在 Go 中，error 是一个接口，其底层实现千差万别：可能是标准库预定义的导出错误（如 http.ErrBodyReadAfterClose、io.EOF），也可能是 *url.Error 这类包装错误（即包含原始错误的结构体），还可能是开发者自定义的错误类型。直接对 err 使用 switch err { case ... } 仅适用于可比较的错误值（如 http.ErrMissingFile），但对 *url.Error 或 *net.OpError 等指针型错误则无效——因为它们是不同实例，地址不同，== 比较恒为 false。

✅ 正确做法一：使用类型断言 + 类型开关（Type Switch）

当错误来自 http.Get 等函数时，常见返回的是 *url.Error，其 Err 字段嵌套了底层错误（如 io.EOF、net.OpError）。此时应先解包再判断：

resp, err := http.Get(url.String())
if err != nil {
    switch e := err.(type) {
    case *url.Error:
        // 解包底层错误
        switch e.Err.(type) {
        case io.EOF:
            fmt.Println("HTTP request ended unexpectedly: EOF")
        case *net.OpError:
            fmt.Printf("Network operation failed: %v\n", e.Err)
        default:
            fmt.Printf("URL error with underlying: %T\n", e.Err)
        }
    case http.ErrBodyReadAfterClose:
        fmt.Println("Read after close error")
    case http.ErrMissingFile:
        fmt.Println("Missing file error")
    case io.EOF:
        fmt.Println("Standalone EOF (e.g., from body read)")
    default:
        fmt.Printf("Unhandled error type: %T\n", err)
        panic(err)
    }
    return
}

? 关键点：err.(type) 是类型开关语法，安全地识别具体错误类型；对 *url.Error 需二次检查 e.Err 才能捕获真正的网络/IO 错误。

Go语言（Golang）1.26.0
Go语言（Golang）1.26.0版本提供 Go 官方 Windows amd64 MSI 安装包下载入口，版本号 1.26.0，可用于旧项目维护、兼容性测试和指定版本开发环境配置。

下载

✅ 正确做法二：定义语义化自定义错误类型

为业务逻辑抽象错误语义，避免暴露底层细节：

type FetchError struct {
    URL     string
    Cause   error
    Timeout bool
}

func (e *FetchError) Error() string {
    msg := fmt.Sprintf("failed to fetch %s", e.URL)
    if e.Timeout {
        msg += " (timeout)"
    }
    if e.Cause != nil {
        msg += ": " + e.Cause.Error()
    }
    return msg
}

func (e *FetchError) Unwrap() error { return e.Cause } // 支持 errors.Is/As (Go 1.13+)

// 使用示例
resp, err := http.Get(url.String())
if err != nil {
    return &FetchError{
        URL:   url.String(),
        Cause: err,
        Timeout: errors.Is(err, context.DeadlineExceeded),
    }
}

随后可结合现代错误处理工具判断：

switch {
case errors.Is(err, io.EOF):
    log.Println("EOF during fetch")
case errors.As(err, &FetchError{}):
    fe := &FetchError{}
    if errors.As(err, &fe) {
        log.Printf("Business fetch error: %v", fe)
    }
case errors.Is(err, http.ErrBodyReadAfterClose):
    log.Println("Invalid body read attempt")
default:
    log.Printf("Unexpected error: %v", err)
}