首页 > Golang > Go教程

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

时间：2025-10-23 19:50:28 353浏览收藏

推广推荐

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

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

自定义错误结构体通过实现Error()方法提供丰富上下文，结合工厂函数和错误包装机制，增强Go程序的错误分类、调用链追踪与处理能力。

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

在 Go 语言中，错误处理是通过实现内置的 error 接口完成的。虽然 errors.New 和 fmt.Errorf 能满足基本需求，但在复杂项目中，使用自定义错误结构体能提供更丰富的上下文信息和更强的可扩展性。

定义自定义错误结构体

通过定义结构体并实现 Error() 方法来创建自定义错误类型：

type MyError struct {
    Code    int
    Message string
    Details string
}

func (e *MyError) Error() string {
    return fmt.Sprintf("[%d] %s: %s", e.Code, e.Message, e.Details)
}

这个结构体包含错误码、简要信息和详细描述，便于日志记录和前端展示。

构造错误的工厂函数

为避免直接暴露结构体字段，推荐使用工厂函数创建错误实例：

func NewMyError(code int, message, details string) *MyError {
    return &MyError{
        Code:    code,
        Message: message,
        Details: details,
    }
}

// 使用示例
err := NewMyError(400, "参数无效", "用户名不能为空")
if err != nil {
    log.Println(err.Error()) // [400] 参数无效: 用户名不能为空
}

结合错误包装（Go 1.13+）

利用 %w 格式符包装底层错误，保留调用链信息：

func validateName(name string) error {
    if name == "" {
        return fmt.Errorf("invalid name: %w", NewMyError(400, "参数缺失", "name 为空"))
    }
    return nil
}

// 错误检查时可用 errors.Is 或 errors.As
if errors.As(err, &myErr) {
    fmt.Printf("错误码: %d\n", myErr.Code)
}

这种方式支持逐层解包，方便定位原始错误。

基本上就这些。自定义错误结构体让程序具备更清晰的错误分类和上下文传递能力，配合标准库的错误包装机制，可构建健壮的错误处理体系。

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