错误应逐层传递并添加上下文，仅在顶层处理时记录日志，使用errors.Wrap增强上下文，结合结构化日志输出error详情与追踪字段，避免敏感信息泄露，确保日志清晰、可追溯。
在Go语言开发中，错误处理和日志记录是保障系统可观测性和稳定性的关键环节。单纯返回error往往不足以定位问题，必须结合日志才能快速排查故障。合理的error与日志结合模式，既能保留调用上下文，又避免重复记录或信息缺失。
不重复记录，选择合适层级打印
常见误区是在每一层都对同一个error打日志，导致日志爆炸。正确做法是：只在错误不再向上返回、或进入最终处理分支（如HTTP响应）时记录日志。
- 底层函数出错，返回带有上下文的error，但不写日志
- 中间层通常只传递error，不做日志记录
- 顶层（如API handler、任务入口）统一记录error日志
使用errors.Wrap增强上下文
标准库的error缺乏堆栈信息，推荐使用pkg/errors或Go 1.13+的error wrapping机制，在传播error时添加上下文。
- 用errors.Wrap(err, "failed to read config")附加语义信息
- 保留原始error类型和堆栈（若使用pkg/errors）
- 在日志中通过%+v格式输出完整堆栈
结构化日志记录error详情
使用结构化日志库（如zap、logrus），将error和其他上下文字段一起输出，便于检索和分析。
立即学习“go语言免费学习笔记（深入）”；
- 记录error的同时带上request_id、user_id等追踪字段
- 把error本身作为独立字段传入，而非拼接进字符串
- 区分error级别：普通error用Error等级，严重故障用Fatal
避免敏感信息泄露
error可能包含路径、SQL、密钥等敏感内容，直接输出有风险。
- 对外暴露的error应净化，内部再记录完整版本
- 自定义error类型控制.Error()方法的输出内容
- 日志系统配置过滤规则，屏蔽特定关键词
基本上就这些。核心是：错误往上传，日志最后打，上下文要全，结构要清。不复杂但容易忽略。
