以示例為例自定義錯誤類型

自定義錯誤類型通過實現error接口提供richer 信息，如ValidationError結構體攜帶字段和消息；2. 使用errors.As可安全提取具體錯誤類型以進行針對性處理；3. 預定義錯誤變量適用於無上下文的狀態錯誤，通過errors.Is判斷相等性；4. 用%w包裝錯誤可保留原始類型和堆棧，便於透傳分析；5. 枚舉式APIError可攜帶錯誤碼，支持類型斷言獲取細節；最佳實踐包括返回指針、避免字符串比較、優先使用errors.As和errors.Is。

在Go 語言中，自定義錯誤類型是一種常見且推薦的做法，尤其是在構建庫或大型應用時。它能提供更豐富的錯誤信息、更好的可讀性和更強的類型控制。下面通過幾個典型的例子，展示如何使用custom error types 。

1. 實現error接口的自定義結構體

最常見的方式是定義一個結構體，並實現Error()方法。

 package main

import "fmt"

// 自定義錯誤類型type ValidationError struct {
    Field string
    Message string
}

// 實現error 接口func (e *ValidationError) Error() string {
    return fmt.Sprintf("validation error on field %q: %s", e.Field, e.Message)
}

// 示例函數，返回自定義錯誤func validateAge(age int) error {
    if age < 0 {
        return &ValidationError{Field: "age", Message: "age cannot be negative"}
    }
    if age > 150 {
        return &ValidationError{Field: "age", Message: "age is unrealistically high"}
    }
    return nil
}

func main() {
    err := validateAge(-5)
    if err != nil {
        fmt.Println(err) // 輸出: validation error on field "age": age cannot be negative
    }
}

✅ 優點：攜帶上下文信息（字段名、原因等）
✅ 建議：返回指針，避免值拷貝和比較問題

2. 使用類型斷言識別錯誤類型

當你需要根據錯誤類型做不同處理時，可以使用類型斷言或errors.As 。

 func main() {
    err := validateAge(-1)
    if err != nil {
        var ve *ValidationError
        if errors.As(err, &ve) {
            fmt.Printf("特定處理: 出錯字段是%s\n", ve.Field)
        } else {
            fmt.Println("未知錯誤:", err)
        }
    }
}

? errors.As()是Go 1.13 推薦方式，能穿透錯誤包裝（如fmt.Errorf("wrap: %w", err) ）

3. 預定義錯誤變量（簡單場景）

對於不需要攜帶數據的錯誤，可以直接定義全局錯誤變量。

 var (
    ErrNotFound = errors.New("resource not found")
    ErrAlreadyExists = errors.New("resource already exists")
)

func findUser(id string) (*User, error) {
    if id == "" {
        return nil, ErrNotFound
    }
    // ...
}

✅ 適合狀態類錯誤，可用errors.Is(err, ErrNotFound)判斷

4. 包裝錯誤並保留原始類型（Go 1.13 ）

使用%w包裝錯誤，同時保留原始錯誤類型信息。

 func readFile(filename string) error {
    data, err := os.ReadFile(filename)
    if err != nil {
        return fmt.Errorf("failed to read config file %s: %w", filename, err)
    }
    // ...
}

func main() {
    err := readFile("config.json")
    if err != nil {
        // 可以檢查底層是否是os.PathError
        var pathErr *os.PathError
        if errors.As(err, &pathErr) {
            fmt.Println("路徑錯誤:", pathErr.Path)
        }
    }
}

5. 枚舉式錯誤類型（帶代碼）

有時你想返回帶錯誤碼的錯誤。

 type APIError struct {
    Code int
    Message string
}

func (e *APIError) Error() string {
    return e.Message
}

var (
    ErrInternal = &APIError{Code: 500, Message: "internal server error"}
    ErrForbidden = &APIError{Code: 403, Message: "permission denied"}
)

func handleRequest() error {
    return ErrForbidden
}

func main() {
    err := handleRequest()
    if apiErr, ok := err.(*APIError); ok {
        fmt.Printf("API 錯誤碼: %d\n", apiErr.Code)
    }
}

最佳實踐總結

• ✅ 使用結構體攜帶錯誤上下文（如字段、ID、狀態）
• ✅ 實現Error()方法返回清晰信息
• ✅ 返回錯誤指針，便於類型比較
• ✅ 使用errors.Is()判斷預定義錯誤
• ✅ 使用errors.As()提取自定義錯誤類型
• ✅ 用%w包裝底層錯誤，保留堆棧和類型
• ❌ 避免直接比較錯誤字符串

基本上就這些常見模式。根據你的場景選擇：簡單用var err = errors.New(...) ，複雜用結構體接口判斷。

以上是以示例為例自定義錯誤類型的詳細內容。更多資訊請關注PHP中文網其他相關文章！