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() 判断。
立即学习“go语言免费学习笔记（深入）”；
示例：
本文档主要讲述的是Android如何使用WebService接口；WebService是一种基于SOAP协议的远程调用标准。通过WebService可以将不同操作系统平台，不同语言、不同技术整合到一起。在OPhone SDK中并没有提供调用WebService的库，因此，需要使用第三方类库（KSOAP2）来调用WebService。在本文将介绍在OPhone中调用WebService的具体细节，并在最后给出一个完整的例子来演示如何使用KSOAP2来调用WebService。感兴趣的朋友可以过来看看
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()) // 可选：仅开发/测试环境
