一、Go 的錯誤處理哲學

Go 的設計哲學鼓勵明確的、顯式的錯誤處理方式。它不像 Java 或 Python 使用異常機制，而是采用了返回值 error 的方式，讓錯誤成為程序流程的一部分。

Go 的錯誤處理核心理念是： 錯誤是值（Errors are values），而非異常。

---

二、error 接口：第一類錯誤處理機制

1. 定義與本質

type?error?interface?{Error()?string
}

任何實現了 Error() string 方法的類型，都可以被當作 error 使用。

2. 使用場景

• 絕大多數業務邏輯錯誤

• IO 錯誤、網絡錯誤、輸入校驗失敗

3. 自定義錯誤

type?MyError?struct?{Code?intMsg??string
}func?(e?MyError)?Error()?string?{return?fmt.Sprintf("code=%d,?msg=%s",?e.Code,?e.Msg)
}

支持更豐富的上下文與分層錯誤處理。

4. errors.New vs fmt.Errorf vs %w

errors.New("something?wrong")
fmt.Errorf("wrap?error:?%w",?err)?//?支持錯誤包裝

Go 1.13 引入的 %w 和 errors.Is / errors.As 組合，增強了錯誤鏈追蹤能力。

---

三、panic/recover：第二類錯誤處理機制

1. panic 的語義

panic 會立即中止當前函數的執行流程，逐層向上回溯調用棧，直到：

• 有 recover 捕獲它；

• 或者程序崩潰。

2. 使用場景

Panic 不是常規的錯誤處理方式，只在不可恢復的場景下使用：

• 數組越界（runtime panic）

• 空指針解引用

• 編程邏輯錯誤（bug）

• 必須中止程序的嚴重錯誤（如配置無法加載）

func?mustLoadConfig()?{data,?err?:=?ioutil.ReadFile("conf.yaml")if?err?!=?nil?{panic(fmt.Sprintf("failed?to?load?config:?%v",?err))}
}

3. recover 的使用

func?safeRun()?{defer?func()?{if?r?:=?recover();?r?!=?nil?{fmt.Println("Recovered?from?panic:",?r)}}()dangerousOperation()
}

注意事項：

• 只有在 defer 中調用 recover 才能生效；

• 一般不推薦濫用 recover 做正常流程控制。

---

四、錯誤處理模式對比

特性	error	panic/recover
用途	常規錯誤，用戶/IO層錯誤	編程錯誤、極端情況
表現	顯式處理流程	類似異常傳播
推薦使用頻率	高頻	低頻（只用于不可恢復錯誤）
控制方式	if err != nil	defer + recover
是否安全	可控、可組合	易誤用、控制流不清晰

---

五、工程實踐建議

? 使用 error 的最佳實踐

1. 明確錯誤語義（定義自定義錯誤類型或用 errors.Join / %w 包裝）

2. 盡量不要忽略 err（使用 linters，如 errcheck）

3. 錯誤鏈 + 錯誤碼設計：可提升服務診斷能力

4. 輸出詳細上下文：fmt.Errorf("failed to open file %s: %w", filename, err)

? panic 的反面案例

func?getValue(index?int)?int?{if?index?>=?len(arr)?{panic("index?out?of?range")}return?arr[index]
}

建議改為返回錯誤，除非你在做庫或底層組件。

---

六、錯誤處理模式進階：error + panic 的融合技巧

1. panic 捕獲封裝為 error 返回

func?SafeCall(f?func())?(err?error)?{defer?func()?{if?r?:=?recover();?r?!=?nil?{err?=?fmt.Errorf("panic?recovered:?%v",?r)}}()f()return?nil
}

適合用于中間件、調度器、插件等運行用戶代碼但不能讓其崩潰的場景。

2. Recover 后重新 panic？

慎用。除非你希望某些 panic 上報后仍讓程序退出。

---

七、小結

問題類型	處理方式
業務層錯誤	使用 error
程序 bug / 不可恢復錯誤	使用 panic
避免程序崩潰	defer + recover 包裹，日志記錄并降級處理

---

附錄：你應該知道的陷阱

• panic 不一定來自你手動觸發，有些來自 runtime（如 nil deref）

• 多層 recover 只能捕獲當前 goroutine 的 panic

• 在并發場景中 panic 會導致整個 goroutine 崩潰