Golang如何实现自定义错误类型并返回_Golang自定义错误类型使用方法汇总-Golang-PHP中文网

Golang如何实现自定义错误类型并返回_Golang自定义错误类型使用方法汇总

P粉602998670

发布： 2025-11-01 17:00:02

原创

673人浏览过

自定义错误类型通过实现 error 接口、使用 errors.As/Is 判断、哨兵错误、错误包装和带状态码错误，提升 Go 项目错误处理的清晰度与健壮性。

golang如何实现自定义错误类型并返回_golang自定义错误类型使用方法汇总

在 Go 语言中，错误处理是通过返回 error 类型值来实现的。虽然 errors.New 和 fmt.Errorf 能满足基本需求，但在复杂项目中，我们常需要携带更多信息或区分错误类型。这时，自定义错误类型就显得尤为重要。以下是 Golang 中实现和使用自定义错误类型的常用方法汇总。

1. 实现 error 接口来自定义错误类型

Go 的 error 是一个接口：

type error interface { Error() string }

只要结构体实现了 Error() 方法，就可以作为错误类型使用。

示例：定义一个网络请求超时错误：

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

type TimeoutError struct {
  URL    string
  Reason string
}

func (e *TimeoutError) Error() string {
  return fmt.Sprintf("timeout accessing %s: %s", e.URL, e.Reason)
}

使用方式：

return &TimeoutError{URL: "https://example.com", Reason: "connection timeout"}

2. 使用 errors.Is 和 errors.As 进行错误判断

从 Go 1.13 开始，errors 包提供了 Is 和 As 函数，用于更精确地判断错误类型。

例如，判断是否为超时错误：

if err := fetch(); err != nil {
  if te, ok := err.(*TimeoutError); ok {
    log.Printf("Timeout on URL: %s", te.URL)
  }
}

更推荐使用 errors.As，它能处理包装过的错误：

百宝箱

百宝箱是支付宝推出的一站式AI原生应用开发平台，无需任何代码基础，只需三步即可完成AI应用的创建与发布。

911

查看详情

var te *TimeoutError
if errors.As(err, &te) {
log.Printf("Timeout on URL: %s", te.URL)
}

3. 使用哨兵错误（Sentinel Errors）

对于不需要附加信息的固定错误，可定义全局错误变量，称为“哨兵错误”。

var ErrNotFound = errors.New("resource not found")

func FindItem(id int) (*Item, error) {
  if item, exists := db[id]; !exists {
    return nil, ErrNotFound
  }
  return &item, nil
}

调用方可用 errors.Is 判断：

if errors.Is(err, ErrNotFound) {
// 处理未找到的情况
}