首页 > Golang > Go教程

Golang自定义错误类型怎么实现

时间：2026-02-22 15:07:41 418浏览收藏

在Go语言中，自定义错误类型远不止是实现简单的`Error() string`方法——它通过结构体携带错误码、时间戳、请求ID等上下文信息，结合类型断言、`errors.As`和`errors.Is`实现精准识别与安全匹配，并支持错误包装（wrapping）以构建可追溯的错误链，从而显著提升错误处理的可读性、灵活性与可靠性；无论你是需要区分HTTP状态码、封装底层异常，还是统一管理超时/连接关闭等通用错误，合理设计自定义错误都能让调试更高效、运维更清晰、系统更健壮。

Golang如何使用error接口定义自定义错误_Golang自定义错误类型实现技巧

在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)
}

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

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 {
        // 处理服务器内部错误
    }
}

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

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

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

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

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

func (e *NetworkError) Error() string {
    return "network error: " + e.Msg + ": " + e.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) 判断是否是某类错误。