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

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

P粉602998670

发布： 2025-11-10 23:51:03

原创

657人浏览过

自定义错误类型可通过实现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)
}

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

立即学习“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视频生成工具

查看详情

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