Go中捕获并记录第三方库错误需显式检查error、用fmt.Errorf("%w", err)包装添加上下文、通过zerolog/zap结构化记录，并依错误类型（如超时、认证失败、缓存未命中）做重试或降级处理。
Go 中捕获并记录第三方库错误，核心在于不忽略返回的 error、合理包装以保留上下文、统一用日志库记录（而非 panic 或 print）。第三方库本身通常只返回 error 接口，不带堆栈或模块信息，需开发者主动增强。
检查并处理每个可能出错的调用
第三方库方法大多以 (result, error) 形式返回，必须显式检查 error 是否为 nil。忽略它会导致静默失败。
常见写法（推荐）：
- 用
if err != nil立即判断，不要累积多个调用后再检查 - 避免
_忽略 error，除非你明确知道该错误可安全丢弃（并加注释说明） - 对关键路径（如 DB 查询、HTTP 调用、文件读写）务必处理，不能假设“一般不会错”
用 errors.Wrap 或 fmt.Errorf 添加上下文
原始 error（比如 io.EOF 或 redis: nil）缺乏调用位置和业务含义。用 github.com/pkg/errors 或 Go 1.13+ 的 fmt.Errorf("%w", err) 包装，能保留原始错误链。
示例：
resp, err := httpClient.Do(req)
if err != nil {
// 包装成带上下文的错误
return nil, fmt.Errorf("failed to call payment API %s: %w", req.URL.String(), err)
}
这样日志里就能看到“哪次调用、哪个 URL、底层什么错”，便于快速定位。
用结构化日志库统一记录（推荐 zerolog 或 zap）
别用 log.Printf 或 fmt.Println 打 error。结构化日志可提取字段（如 service、method、status_code），方便检索和告警。
示例（zerolog）：
if err != nil {
log.Error().
Str("service", "payment").
Str("endpoint", "/v1/charge").
Err(err).
Msg("third-party API call failed")
return err
}
注意：.Err(err) 会自动展开错误链（含 wrapped message 和 stack，如果用了支持的 error 包），比手动 sprintf 更可靠。
区分错误类型，按需重试或降级
第三方错误不都一样。网络超时可重试，认证失败要告警，限流错误需降级。可用类型断言或错误谓词判断：
- 对
net.OpError、context.DeadlineExceeded做指数退避重试 - 用
errors.Is(err, redis.Nil)判断缓存未命中，而非字符串匹配 - 对
stripe.Error这类 SDK 自定义错误，直接访问其Code、Param字段做业务分支
基本上就这些。关键不是“怎么记”，而是“记全上下文 + 分清性质 + 统一出口”。不复杂但容易忽略。
