如何在Golang中处理第三方库错误_包装并提供统一接口

Go中处理第三方库错误应包装原始错误并定义自定义错误类型，统一响应与日志策略。使用fmt.Errorf("%w", err)或errors.Wrap添加上下文；定义ErrNotFound等结构体错误并实现Is()方法；在HTTP层映射为标准状态码与提示；日志记录顶层消息与根因。

在 Go 中处理第三方库错误的关键是避免直接暴露底层错误细节，而是通过错误包装和自定义错误类型，构建清晰、可维护、对调用方友好的统一错误接口。

使用 errors.Wrap 或 fmt.Errorf 包装原始错误

第三方库返回的错误（如 *os.PathError、sql.ErrNoRows）通常缺乏上下文或业务语义。用 errors.Wrap（来自 github.com/pkg/errors）或 Go 1.13+ 的 fmt.Errorf("%w", err) 添加调用链信息，保留原始错误供判断，同时增强可读性。

例如：

// 使用 fmt.Errorf（推荐，原生支持）
if err != nil {
    return fmt.Errorf("failed to fetch user from database: %w", err)
}

// 使用 errors.Wrap（需引入包）
if err != nil {
    return errors.Wrap(err, "failed to parse config file")
}

定义业务错误类型，实现 error 接口并支持分类判断

为常见错误场景定义结构体错误类型（如 ErrNotFound、ErrInvalidInput），内嵌 error 字段或实现 Error() 方法，并提供 Is() 方法便于外部用 errors.Is() 判断。

示例：

type ErrNotFound struct {
    error
}

func (e *ErrNotFound) Is(target error) bool {
    _, ok := target.(*ErrNotFound)
    return ok
}

func NewNotFound(err error) error {
    return &ErrNotFound{err}
}

// 使用
if errors.Is(err, &ErrNotFound{}) {
    // 处理未找到逻辑
}

统一错误响应层：封装 HTTP/API 错误码与消息

在服务入口（如 HTTP handler）中，将内部错误映射为标准化响应。不直接返回原始错误，而是根据错误类型提取状态码、用户提示、日志级别等。

建议做法：

• 定义错误码枚举（如 CodeNotFound = 404、CodeInternal = 500）
• 编写 ErrorResponse(err error) (int, string) 函数，内部用 errors.As 或 errors.Is 匹配自定义错误类型
• 对敏感错误（如数据库连接失败）返回泛化提示（“服务暂时不可用”），避免泄露技术细节

日志记录时区分错误层级，避免重复打印原始错误

包装后的错误链可能很长。记录日志时，应只输出顶层错误消息 + 关键上下文，同时用结构化日志记录原始错误（如 err.Unwrap() 或 errors.Cause()）用于排查。

例如：

log.Error("user creation failed",
    "message", err.Error(),              // 顶层包装消息
    "cause", errors.Cause(err).Error(), // 根因（如 "connection refused"）
    "stack", debug.Stack())             // 可选：仅开发/测试环境