首页 > Golang > Go教程

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

时间：2025-12-23 23:29:32 375浏览收藏

哈喽！大家好，很高兴又见面了，我是golang学习网的一名作者，今天由我给大家带来一篇《Golang自定义错误类型实现方法》，本文主要会讲到等等知识点，希望大家一起学习进步，也欢迎大家关注、点赞、收藏、转发! 下面就一起来看看吧！

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

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) 判断是否是某类错误。

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

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

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

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

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

今天带大家了解了的相关知识，希望对你有所帮助；关于Golang的技术知识我们会一点点深入介绍，欢迎大家关注golang学习网公众号，一起学习编程~