Golang自定义错误类型详解教程

掌握Golang自定义错误类型，提升代码健壮性！本文深入解析Go语言中自定义错误类型的实现方法，通过定义结构体并实现`Error()`方法，创建包含`Code`、`Message`等自定义字段的错误类型，方便携带更丰富的错误上下文信息。重点讲解如何利用类型断言或`errors.As`获取错误详细信息，以及如何结合`%w`包装错误以增强上下文，便于错误判断与处理。使用指针接收者避免不必要的拷贝，保持错误语义清晰，提升代码可维护性。无论你是Go语言新手还是有一定经验的开发者，本文都能帮助你更好地理解和应用自定义错误类型，编写更健壮、更易于调试的Go程序。

定义结构体并实现Error方法可创建自定义错误类型，如MyError含Code、Message等字段；通过指针接收者避免拷贝；支持类型断言或errors.As获取详细信息；结合%w包装错误以增强上下文；便于错误判断与处理。

在Go语言中，自定义错误类型是一种常见且推荐的做法，尤其当你需要携带更丰富的上下文信息或区分不同错误场景时。Go的error是一个接口，只要实现了Error() string方法的类型都可以作为错误使用。

定义结构体实现 error 接口

最常用的方式是定义一个结构体，并为它实现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 doSomething() error {
    return &MyError{
        Code:    400,
        Message: "Invalid input",
        Details: "Name cannot be empty",
    }
}

使用自定义字段进行错误判断

由于你拥有完整的类型控制，可以在外层通过类型断言或类型switch来判断错误类型并获取额外信息：

if err := doSomething(); err != nil {
    if myErr, ok := err.(*MyError); ok {
        fmt.Printf("Error code: %d\n", myErr.Code)
        if myErr.Code == 400 {
            // 处理客户端错误
        }
    }
}

结合 errors.Is 和 errors.As（Go 1.13+）

如果你希望支持现代Go的错误包装和比较机制，可以结合fmt.Errorf与%w来包装自定义错误，或者实现Is和Unwrap方法。

例如，让自定义错误支持errors.As：

var ErrValidation = &MyError{Code: 400, Message: "Validation failed"}

// 在函数中使用
return fmt.Errorf("failed to process request: %w", ErrValidation)

// 调用端判断
if errors.As(err, &target *MyError{}) {
    fmt.Println("It's a MyError:", target.Code)
}

基本上就这些。定义结构体、实现Error()方法，再根据需要支持类型断言或errors.As，就能灵活地管理程序中的错误流。不复杂但容易忽略的是：记得用指针接收者实现方法，避免拷贝；同时保持错误语义清晰，便于调用方处理。

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