1. Go 错误处理哲学：error 接口设计、与异常的区别、Go 团队推荐模式

Go 语言的错误处理哲学是其设计中最具辨识度的特征之一。与 Java、Python、C# 等语言不同，Go 没有提供传统的 try-catch-finally 异常机制，而是通过显式的 error 接口值来传递错误。这种设计迫使开发者将错误视为普通值，在调用处立即处理，而非将其抛到调用栈上层。

1.1 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 方法的类型都可以作为错误值传递。这种设计带来了三个核心优势：

• 零依赖：标准库无需引入任何异常类层次结构。
• 可组合：通过包装（wrapping）机制，错误可以携带上下文信息。
• 可断言：通过类型断言或接口检查，调用方可以精确判断错误种类。

1.2 与异常的区别

下表从多个维度对比 Go 的 error 模式与传统语言的异常机制：

1.3 Go 团队推荐模式

Go 官方在博客、演讲和代码评审中反复强调以下实践原则：

1. 错误只处理一次：不要在同一个函数内既记录日志又返回错误，否则会导致日志重复。
2. 使用哨兵错误（Sentinel Errors）：定义包级别的错误变量，供调用方用 == 比较。
3. 使用自定义错误类型：当需要携带额外上下文时，定义结构体实现 error 接口。
4. 使用错误包装（Wrapping）：通过 fmt.Errorf("context: %w", err) 保留错误链。
5. 使用 errors.Is 和 errors.As：分别用于检查错误链中的哨兵错误和自定义类型。

以下代码展示了推荐模式的核心用法：

// 哨兵错误定义
var ErrNotFound = errors.New("resource not found")

// 自定义错误类型
type ValidationError struct {
    Field string
    Msg   string
}

func (e *ValidationError) Error() string {
    return fmt.Sprintf("validation failed on %s: %s", e.Field, e.Msg)
}

// 使用示例
func GetUser(id int) (*User, error) {
    if id <= 0 {
        return nil, &ValidationError{Field: "id", Msg: "must be positive"}
    }
    // ... 查询逻辑
    if user == nil {
        return nil, fmt.Errorf("get user %d: %w", id, ErrNotFound)
    }
    return user, nil
}

// 调用方断言
user, err := GetUser(-1)
if err != nil {
    if errors.Is(err, ErrNotFound) {
        // 处理未找到
    }
    var ve *ValidationError
    if errors.As(err, &ve) {
        fmt.Printf("字段 %s 验证失败: %s\n", ve.Field, ve.Msg)
    }
}

1.4 错误处理流程对比图

下图直观展示了 Go 显式错误处理与传统异常隐式传播的流程差异：

1.5 错误断言与权限验证的桥梁

理解 Go 的错误处理哲学是后续章节中实现错误码断言和权限验证的基础。在搜索业务场景中，错误码断言通常需要：

• 定义业务相关的哨兵错误（如 ErrPermissionDenied、ErrTokenExpired）。
• 使用自定义错误类型携带用户 ID、资源路径、操作类型等上下文。
• 通过 errors.Is 和 errors.As 在中间件层统一断言并返回 HTTP 状态码。