Golang自定义错误结构体与方法定义-Golang-PHP中文网

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

P粉602998670

发布： 2025-09-07 08:07:02

原创

405人浏览过

自定义错误结构体通过实现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 接口，可作为错误返回。

创建错误实例的工厂函数

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

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

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

登录后复制

使用方式如下：

eMart 网店系统

功能列表：底层程序与前台页面分离的效果，对页面的修改无需改动任何程序代码。完善的标签系统，支持自定义标签，公用标签，快捷标签，动态标签，静态标签等等，支持标签内的vbs语法，原则上运用这些标签可以制作出任何想要的页面效果。兼容原来的栏目系统，可以很方便的插入一个栏目或者一个栏目组到页面的任何位置。底层模版解析程序具有非常高的效率，稳定性和容错性，即使模版中有错误的标签也不会影响页面的显示。所有的标

查看详情

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自定义错误结构体与方法定义的详细内容，更多请关注php中文网其它相关文章！