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

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

P粉602998670

发布： 2025-10-03 14:58:02

原创

701人浏览过

自定义错误结构体通过实现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)
}

登录后复制

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

构造错误的工厂函数

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

法语写作助手

法语助手旗下的AI智能写作平台，支持语法、拼写自动纠错，一键改写、润色你的法语作文。

查看详情

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

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