自定义错误类型可通过实现Error接口携带上下文信息，如错误码、时间戳等，并支持通过类型断言、errors.As和errors.Is进行精确匹配与包装处理，提升错误处理的灵活性与可靠性。

在go语言中，error 是一个内置接口，定义如下：

type error interface {
    Error() String
}

任何实现了 Error() 方法的类型都可以作为错误使用。虽然Go标准库中的 errors.New 和 fmt.Errorf 能满足大多数简单场景，但在实际开发中，我们常常需要携带更多信息或区分错误类型。这时，自定义错误类型就显得尤为重要。

定义结构体实现 error 接口

最常见的方式是定义一个结构体，并为其实现 Error() 方法。这样可以携带上下文信息，比如错误码、时间戳、请求ID等。

type MyError Struct {
    Code int
    Message string
    Time time.Time
}

func (e *MyError) Error() string {
    return fmt.Sprintf(“[%d] %s at %v”, e.Code, e.Message, e.Time)
}

使用时可以直接创建实例：

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

err := &MyError{
    Code: 404,
    Message: “Resource not found”,
    Time: time.Now(),
}

调用 fmt.Println(err) 会输出格式化后的错误信息。

通过类型断言获取详细错误信息

自定义错误的优势在于可以在外层捕获并解析具体类型，从而做出不同处理。

if e, ok := err.(*MyError); ok {
    if e.Code == 404 {
        // 处理未找到资源的情况
    } else if e.Code == 500 {
        // 处理服务器内部错误
    }
}

这种方式比单纯判断错误字符串更安全、更灵活。

通义视频

通义万相AI视频生成工具

70

查看详情

使用 errors.Is 和 errors.As 进行现代错误比较

从Go 1.13开始，推荐使用 errors.Is 和 errors.As 来处理包装错误。

如果你希望自定义错误支持包装（wrapping），可以在结构体中嵌入底层错误：

type NetworkError struct {
    Msg string
    Err error // 嵌入原始错误
}

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

这样就可以使用 errors.As 提取特定类型：

var netErr *NetworkError
if errors.As(err, &netErr) {
    log.Printf(“Network issue: %v”, netErr.Msg)
}

也可以用 errors.Is(err, target) 判断是否是某类错误。

预定义错误变量提升可读性

对于不带额外状态的通用错误，可以像标准库一样定义全局变量：

var (
    ErrConnectionClosed = errors.New(“connection already closed”)
    ErrTimeout = errors.New(“operation timed out”)
)

这些变量可在多个包中复用，配合 errors.Is(err, ErrTimeout) 使用效果更佳。

基本上就这些。关键是根据业务需求决定是否需要结构化错误信息，以及是否要支持错误包装和类型识别。合理设计能让错误处理更清晰可靠。