Go 語言錯誤處理藝術：從 error 接口到優雅的鏈式錯誤管理

Go 語言錯誤處理藝術：從 error 接口到優雅的鏈式錯誤管理

Go 拋棄了傳統的 try/catch 異常機制，採用多返回值約定：最後一個返回值為 error 表示執行狀態。本文深入解析 error 接口本質、構造方法、自定義錯誤類型，並展示如何將重複的 if err != nil 重構為優雅的鏈式檢查模式。

一、error 接口本質

type error interface {
    Error() string
}

任何實現了 Error() string 方法的類型均滿足 error 接口。

二、構造 error 的兩種標準方式

1. errors.New() —— 靜態錯誤訊息

var dividedErr = errors.New("Cant divided by 0")

2. fmt.Errorf() —— 動態格式化訊息

err := fmt.Errorf("%d cant divided by 0", arg)

三、自定義錯誤類型攜帶上下文

type division struct {
    arg int
    str string
}

func (e *division) Error() string {
    return fmt.Sprintf("%d %s", e.arg, e.str)
}

func divideCheck(arg1, arg2 int) error {
    if arg2 == 0 {
        return &division{arg1, "can't divided by 0"}
    }
    return nil
}

四、基礎錯誤處理模式 (冗長)

func main() {
    var err error
    err = divideCheck(4, 2)
    if err != nil { fmt.Println(err); return }
    err = divideCheck(8, 0)
    if err != nil { fmt.Println(err); return }
}

每次調用需 3 行處理，代碼嘈雜。

五、優化：內部狀態聚合模式 (優雅)

type division struct {
    err error
}

func (d *division) DivideCheck(arg1, arg2 int) {
    if d.err != nil { return }  // 已有錯誤，快速返回
    if arg2 == 0 {
        d.err = fmt.Errorf("%d can't divided by 0", arg1)
    }
}

func (d *division) Err() error { return d.err }

func main() {
    d := new(division)
    d.DivideCheck(4, 2)
    d.DivideCheck(8, 0)   // 觸發錯誤
    if d.Err() != nil {
        fmt.Println(d.Err()) // 統一處理
    }
}

優勢：

• 調用鏈簡潔，無重複 if err != nil
• 首錯即停，後續調用近零成本跳過
• 統一錯誤出口，便於日誌、上報

六、進階建議

• 使用 pkg/errors 或 Go 1.13+ fmt.Errorf("%w", err) 支援錯誤包裝與堆疊追蹤。
• 哨兵錯誤 (var ErrNotFound = errors.New("not found")) 配合 errors.Is() 判斷特定錯誤。
• 自定義錯誤類型實現 Unwrap() 支援錯誤鏈遍歷。

Go 的錯誤處理常被詬病，但掌握「以 Go 的方式編程」—— 值語義、組合優於繼承、顯式錯誤流 —— 依然能寫出清晰、健壯的代碼。