当前位置：首页 > 文章列表 > Golang > Go教程 > Golang自定义错误详解与教程

Golang自定义错误详解与教程

2025-12-03 23:38:29 0浏览收藏

推广推荐

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

本篇文章向大家介绍《Golang errors包自定义错误教程》，主要包括，具有一定的参考价值，需要的朋友可以参考一下。

Go语言中错误处理通过error类型实现，支持errors.New创建简单错误、结构体实现带上下文的自定义错误、fmt.Errorf结合%w包装错误链，并用errors.Is/As进行精准判断。

如何在Golang中使用errors创建自定义错误_Golang errors错误处理方法

在Go语言中，错误处理是通过返回error类型值来实现的。虽然Go内置了简单的错误创建方式（如errors.New和fmt.Errorf），但在实际开发中，我们经常需要创建自定义错误类型，以便携带更丰富的上下文信息或支持特定的行为判断。

使用 errors.New 创建基础自定义错误

对于不需要额外字段的简单错误，可以直接使用errors.New创建一个带有描述信息的错误。

package main

import (
    "errors"
    "fmt"
)

var ErrInvalidInput = errors.New("invalid input")

func divide(a, b int) (int, error) {
    if b == 0 {
        return 0, ErrInvalidInput
    }
    return a / b, nil
}

func main() {
    _, err := divide(10, 0)
    if err != nil {
        fmt.Println(err) // 输出: invalid input
    }
}

这种方式适合预定义的、固定的错误场景。由于ErrInvalidInput是一个变量，可以在多个地方复用，并通过==直接比较错误类型。

定义结构体实现自定义错误类型

当需要携带错误发生时的具体信息（如时间、代码、字段名等），可以定义一个结构体并实现error接口的Error()方法。

package main

import (
    "fmt"
)

type ValidationError struct {
    Field   string
    Message string
}

func (e *ValidationError) Error() string {
    return fmt.Sprintf("validation error in field '%s': %s", e.Field, e.Message)
}

func validateEmail(email string) error {
    if email == "" {
        return &ValidationError{Field: "email", Message: "cannot be empty"}
    }
    // 模拟其他校验逻辑
    if !containsAt(email) {
        return &ValidationError{Field: "email", Message: "must contain @"}
    }
    return nil
}

func containsAt(s string) bool {
    for _, c := range s {
        if c == '@' {
            return true
        }
    }
    return false
}

func main() {
    err := validateEmail("")
    if err != nil {
        fmt.Println(err) // 输出: validation error in field 'email': cannot be empty
        // 可以进行类型断言获取详细信息
        if v, ok := err.(*ValidationError); ok {
            fmt.Printf("Field: %s, Msg: %s\n", v.Field, v.Message)
        }
    }
}

这种做法的优势在于能传递结构化信息。调用方可以通过类型断言还原原始错误类型，从而做出更精确的处理决策。

使用 fmt.Errorf 包装错误并添加上下文

从 Go 1.13 开始，fmt.Errorf支持使用%w动词包装原始错误，形成错误链。这在构建复杂系统时非常有用。

package main

import (
    "fmt"
)

func readFile(name string) error {
    return fmt.Errorf("could not open file %s: %w", name, fmt.Errorf("permission denied"))
}

func processFile(name string) error {
    err := readFile(name)
    if err != nil {
        return fmt.Errorf("failed to process file: %w", err)
    }
    return nil
}

func main() {
    err := processFile("config.txt")
    if err != nil {
        fmt.Println("Error:", err)
        // 使用 errors.Unwrap 测试是否包含特定错误
        if inner := err.Unwrap(); inner != nil {
            fmt.Println("Unwrapped:", inner)
        }
        // 或者使用 errors.Is 判断是否是某个错误
        if errors.Is(err, os.ErrPermission) { // 示例：假设原错误是 os.ErrPermission
            fmt.Println("It's a permission issue.")
        }
    }
}

注意：%w只能用于fmt.Errorf，且每个格式字符串最多只能有一个%w。被包装的错误可以通过errors.Is和errors.As进行检查和提取。

利用 errors.Is 和 errors.As 进行错误判断

推荐使用errors.Is代替比较错误，使用errors.As代替类型断言，这样可以正确处理包装过的错误。

if errors.Is(err, ErrInvalidInput) {
    // 处理特定错误，即使它被多层包装也能识别
}

var validationErr *ValidationError
if errors.As(err, &validationErr) {
    // 成功将 err 解包并赋值给 validationErr
    fmt.Printf("Validation failed on field: %s\n", validationErr.Field)
}

这两个函数能穿透%w形成的错误链，使错误处理更加灵活和健壮。

基本上就这些。根据实际需求选择合适的方式：固定错误用errors.New，需携带数据用自定义结构体，多层调用建议用fmt.Errorf("%w")包装，并配合errors.Is与errors.As做判断。不复杂但容易忽略细节。

文中关于的知识介绍，希望对你的学习有所帮助！若是受益匪浅，那就动动鼠标收藏这篇《Golang自定义错误详解与教程》文章吧，也可关注golang学习网公众号了解相关技术文章。