Go语言第三方库错误处理模式围绕上下文保留、分类处理和调试便利展开，常见实践包括：1. 错误包装（%w）结合errors.Is/As实现链式判断；2. 自定义错误类型携带错误码等元信息用于分支处理；3. 错误码系统配合工厂函数和IsXXX辅助函数提升语义清晰度；4. 集成堆栈追踪或结合结构化日志记录调用栈，增强可调试性。
Go语言的错误处理以简洁直接著称，标准库通过返回
error接口实现。在实际开发中，第三方库为了增强错误的可读性、可追溯性和分类处理能力，演化出多种错误处理模式。下面分析几种常见的第三方库错误处理实践及其设计思路。
1. 错误包装（Error Wrapping）
Go 1.13引入
fmt.Errorf的
%w动词，支持错误包装，使调用链中的上下文信息得以保留。许多第三方库基于此构建层级错误结构。
例如：
if err != nil {
return fmt.Errorf("failed to read config: %w", err)
}
使用
errors.Is和
errors.As可以递归判断错误类型或提取原始错误：
立即学习“go语言免费学习笔记（深入）”；
errors.Is(err, target)
判断错误链中是否包含目标错误errors.As(err, &target)
将错误链中某一类型赋值给目标变量
这种模式在数据库驱动（如
sqlx）、HTTP客户端（如
resty）中广泛使用，便于在不丢失原始错误的前提下添加上下文。
2. 自定义错误类型（Custom Error Types）
一些库定义结构体实现
error接口，携带额外信息用于分类处理。
例如：
type AppError struct {
Code string
Message string
Cause error
}
func (e *AppError) Error() string {
return e.Message
}
这种模式常见于微服务框架（如
go-kit），允许通过类型断言获取错误码、日志级别、是否可重试等元信息。
调用方可以这样处理：
if appErr, ok := err.(*AppError); ok {
switch appErr.Code {
case "TIMEOUT":
// 重试逻辑
case "AUTH_FAILED":
// 返回401
}
}
3. 错误生成器与错误码系统
大型项目或框架（如
gRPC-Go、
etcd）常使用预定义错误码配合错误工厂函数。
例如：
var ErrInvalidRequest = errors.New("invalid request")
func NewError(code int, msg string) error {
return &StatusError{Code: code, Msg: msg}
}
这类库通常提供
IsXXX(err)辅助函数判断错误类别：
status.IsNotFound(err)
grpc.IsUnavailable(err)
这种设计提升错误判断的语义清晰度，避免字符串比较或类型断言污染业务代码。
4. 错误追踪与日志集成
部分库（如
pkg/errors）在Go 1.13前提供堆栈追踪功能，通过
errors.WithStack()记录错误发生时的调用栈。
尽管标准库现已支持包装，但
pkg/errors仍被沿用，因其提供更丰富的打印格式（如
%+v输出完整堆栈）。
现代做法趋向于结合日志库（如
zap、
slog）在记录错误时附加堆栈：
logger.Error("operation failed", "err", err, "stack", string(debug.Stack()))
这种方式解耦错误生成与日志输出，更符合关注点分离原则。
基本上就这些。第三方库的错误处理模式围绕“保留上下文”、“支持分类”、“便于调试”三个目标展开。合理利用标准库的包装机制，结合自定义类型和辅助函数，能构建清晰可控的错误处理流程。
