首页 > Golang > Go教程

Golang自定义错误结构体使用教程

时间：2025-12-29 21:05:37 104浏览收藏

有志者，事竟成！如果你在学习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学习网公众号吧！