错误处理

这一课你将能做到

1. 用 errors.New / fmt.Errorf 创建错误，自定义错误类型，并按 (T, error) 规范层层返回
2. 用 %w 包装错误形成错误链，并用 errors.Is / errors.As 精准判断
3. 说清 panic/recover 的适用边界，写出能 recover 的防御代码

为什么要学

Go 没有 try/catch。错误是普通的返回值：函数显式返回 error，调用方显式处理。好处是控制流全部写在明面上——哪一行可能失败、失败后走哪条路，一目了然；代价是满屏 if err != nil，你需要一套规范让它不变成灾难。

这套规范就是本课内容：创建、包装、判断、兜底。写服务时它是日常；面试时 errors.Is/As、wrap 链、panic 边界是固定考题。

先建立图像

错误像快递单在调用链上逐层「贴单」：

readConfig()          "读取配置失败: %w"
  └── readFile()      "打开文件失败: %w"
        └── os.Open   open config.yaml: no such file or directory  ← 根因

错误链（wrap 链）：
"读取配置失败: 打开文件失败: open config.yaml: no such file or directory"
 ↑ 最外层是当下语境           ↑ 中间层              ↑ 最内层是原始根因

errors.Is(err, fs.ErrNotExist)  → 顺着链找根因，true
errors.As(err, &pathErr)        → 顺着链找某类型的错误对象

每一层只负责两件事：决定自己处理还是上抛；上抛时用 %w 附加上下文。

跟着做

步骤 1：创建错误——两种基本姿势

package main

import (
	"errors"
	"fmt"
)

func sqrtGuess(n float64) (float64, error) {
	if n < 0 {
		// errors.New：静态固定文案
		return 0, errors.New("n 不能为负数")
	}
	// 这里的近似算法只作演示
	guess := n
	for i := 0; i < 10; i++ {
		guess = (guess + n/guess) / 2
	}
	return guess, nil
}

func main() {
	v, err := sqrtGuess(-4)
	if err != nil {
		fmt.Println("出错了:", err)
		return
	}
	fmt.Println(v)
}

需要动态信息时用 fmt.Errorf（本质是先格式化再 errors.New）：

// fmt.Errorf("用户 %d 不存在", id) → "用户 42 不存在"

步骤 2：自定义错误类型——携带结构化信息

error 只是接口，任何类型实现 Error() string 都能当错误用：

package main

import (
	"errors"
	"fmt"
)

// 自定义错误：错误码、字段名都结构化保留，调用方可以按需取用
type ValidationError struct {
	Field string
	Msg   string
}

func (e *ValidationError) Error() string {
	return fmt.Sprintf("字段 %s 校验失败: %s", e.Field, e.Msg)
}

func checkAge(age int) error {
	if age < 0 || age > 150 {
		return &ValidationError{Field: "age", Msg: "超出合理范围"}
	}
	return nil
}

func main() {
	err := checkAge(-1)
	fmt.Println(err) // 字段 age 校验失败: 超出合理范围

	var ve *ValidationError
	if errors.As(err, &ve) { // 还原成具体类型，拿到结构化字段
		fmt.Println("出错字段:", ve.Field)
	}

	var e2 error = errors.New("普通错误")
	fmt.Println(errors.As(e2, &ve)) // false：类型不匹配，安全返回
}