2. Go 错误处理基础：语言哲学与核心接口

Go 语言的错误处理哲学与 C/Java/Python 等主流语言截然不同。它不采用异常抛出（throw-catch）机制，而是将错误视为普通值，通过函数返回值显式传递。这种设计迫使开发者必须直面每一个可能出错的调用，从而在编译期就消除“未处理异常”的隐患。

2.1 Go 错误处理哲学：显式、可预测、无异常

Go 团队在设计错误处理时遵循三条核心原则：

• 错误是值（Errors are values）：错误与普通变量无异，可赋值、可比较、可传递。
• 显式处理（Explicit handling）：每个可能返回错误的函数调用都必须检查返回值，不存在隐式传播。
• 无异常栈展开（No exception stack unwinding）：错误不会自动沿调用栈向上冒泡，必须由开发者手动传递。

下表对比了 Go 与主流语言的错误处理差异：

2.2 error 接口：一切错误的基础

Go 语言通过预定义的 error 接口统一所有错误类型。该接口只包含一个方法：

// The error built-in interface type is the conventional interface for
// representing an error condition, with the nil value representing no error.
type error interface {
    Error() string
}

任何实现了 Error() string 方法的类型都可以作为错误值使用。这意味着你可以为错误附加结构化信息，而不仅仅是字符串。

下面这张 SVG 图展示了 error 接口在 Go 类型系统中的核心位置：

2.3 errors.New：创建简单错误

errors.New 是最基础、最轻量的错误创建方式。它接收一个字符串，返回一个包含该字符串的 error 值。

package errors

// New returns an error that formats as the given text.
// Each call to New returns a distinct error value even if the text is identical.
func New(text string) error {
    return &errorString{text}
}

// errorString is a trivial implementation of error.
type errorString struct {
    s string
}

func (e *errorString) Error() string {
    return e.s
}

使用示例：

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

func GetUser(id int) (*User, error) {
    if id <= 0 {
        return nil, ErrNotFound
    }
    // ... 正常逻辑
    return &user, nil
}

// 调用方
user, err := GetUser(-1)
if err != nil {
    if err == ErrNotFound {  // 注意：这里可以工作，因为 ErrNotFound 是包级变量
        fmt.Println("用户不存在")
    }
}

2.4 fmt.Errorf：带格式的错误创建

fmt.Errorf 在 errors.New 的基础上增加了格式化能力，允许将动态值嵌入错误消息。从 Go 1.13 开始，它还支持通过 %w 动词包装错误，实现错误链。

// 基本用法：格式化错误消息
err := fmt.Errorf("user %d not found in database", userID)

// 包装错误（Go 1.13+）：使用 %w 动词
if err != nil {
    return fmt.Errorf("failed to query user %d: %w", userID, err)
}

// 多个错误包装
err1 := errors.New("connection timeout")
err2 := fmt.Errorf("step 1 failed: %w", err1)
err3 := fmt.Errorf("step 2 failed: %w", err2)
// err3 的错误链：err3 -> err2 -> err1

下表对比了 errors.New 与 fmt.Errorf 的适用场景：

2.5 错误断言与审计基线

在 Go 代码审计中，错误处理相关的检查点构成了审计基线的基础。以下是必须覆盖的检查项：

• 错误值检查：所有返回 error 的函数调用必须检查返回值，禁止使用 _ 丢弃。
• 错误比较方式：哨兵错误使用 errors.Is，自定义错误类型使用 errors.As，禁止直接 == 比较（除非是包级变量）。
• 错误包装规范：使用 fmt.Errorf("context: %w", err) 保留错误链，禁止使用 + 拼接字符串丢失原始错误。
• 错误类型设计：避免在错误消息中包含敏感信息（密码、令牌、SQL 语句等）。
• nil 接口陷阱：检查返回 nil 错误时是否返回了非 nil 的接口值（常见于返回 (*MyError)(nil) 的情况）。

下面这张 SVG 图展示了 Go 错误处理的核心流程与审计检查点：

2.6 常见错误模式与审计案例

以下是审计中频繁出现的错误处理反模式：

// 反模式 1：静默丢弃错误
resp, _ := http.Get("https://example.com/api")
// 如果 Get 失败，resp 为 nil，后续使用 resp.Body 会 panic

// 反模式 2：错误比较方式错误
err := doSomething()
if err == errors.New("specific error") {  // 永远为 false！每次 New 都分配新指针
    // 处理逻辑
}

// 反模式 3：丢失原始错误
return fmt.Errorf("failed: " + err.Error())  // 丢失了错误链，无法使用 errors.Is

// 正确做法
return fmt.Errorf("failed: %w", err)  // 保留错误链

// 反模式 4：返回 nil 接口但包含非 nil 指针
func getError() error {
    var p *MyError = nil
    if someCondition {
        p = &MyError{msg: "something wrong"}
    }
    return p  // 当 someCondition 为 false 时，返回的接口不是 nil！
}

// 调用方
if err := getError(); err != nil {  // 永远为 true！
    // 即使没有错误也会进入这里
}