首页 > Golang > Go教程

Golang自定义错误结构体及方法应用

时间：2025-12-19 10:25:30 464浏览收藏

推广推荐

支持 PC / 移动端，安全直达

哈喽！今天心血来潮给大家带来了《Golang自定义错误结构体与方法使用》，想必大家应该对Golang都不陌生吧，那么阅读本文就都不会很困难，以下内容主要涉及到，若是你正在学习Golang，千万别错过这篇文章~希望能帮助到你！

自定义错误结构体通过实现Error方法携带错误码、时间戳等信息，结合工厂函数和errors.As进行类型判断，可扩展StatusCode、IsRetryable等方法，提升Go错误处理的可编程性与灵活性。

Golang自定义错误结构体与方法定义

在Go语言中，错误处理是通过返回 error 类型值来实现的。虽然内置的 errors.New 和 fmt.Errorf 能满足基本需求，但在复杂场景中，我们常需要携带更多信息的错误类型。这时，自定义错误结构体就非常有用。

定义自定义错误结构体

你可以通过定义一个结构体来封装错误信息，比如错误码、时间戳、上下文等：

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

func (e *MyError) Error() string {
    return fmt.Sprintf("[%v] ERROR %d: %s", e.Time.Format("2006-01-02 15:04:05"), e.Code, e.Message)
}

只要实现了 Error() string 方法，该结构体就满足 error 接口，可作为错误返回。

创建错误实例的工厂函数

为了方便使用，通常定义一个构造函数来创建自定义错误：

func NewMyError(code int, message string) *MyError {
    return &MyError{
        Code:    code,
        Message: message,
        Time:    time.Now(),
    }
}

使用方式如下：

func doSomething() error {
    // 模拟出错
    return NewMyError(404, "resource not found")
}

在实际中使用并判断错误类型

调用方可以通过类型断言或 errors.As 来识别具体错误类型，从而做出不同处理：

err := doSomething()
if err != nil {
    var myErr *MyError
    if errors.As(err, &myErr) {
        fmt.Printf("错误码: %d, 消息: %s, 时间: %v\n", myErr.Code, myErr.Message, myErr.Time)
    } else {
        fmt.Println("未知错误:", err)
    }
}

errors.As 是Go 1.13+推荐的方式，比直接类型断言更安全，支持嵌套错误。

附加方法增强错误能力

你还可以为错误结构体添加其他方法，比如获取HTTP状态码、是否可重试等：

func (e *MyError) StatusCode() int {
    switch e.Code {
    case 404:
        return 404
    case 500:
        return 500
    default:
        return 400
    }
}

func (e *MyError) IsRetryable() bool {
    return e.Code >= 500 // 服务端错误可重试
}

这样上层逻辑可以根据这些方法做更智能的处理，比如重试机制或日志分级。

基本上就这些。自定义错误结构体让Go的错误处理不再只是“字符串”，而是可编程、可扩展的信息载体。关键是实现 Error() 方法，并合理设计结构和辅助方法。不复杂但容易忽略。

今天关于《Golang自定义错误结构体及方法应用》的内容介绍就到此结束，如果有什么疑问或者建议，可以在golang学习网公众号下多多回复交流；文中若有不正之处，也希望回复留言以告知！