Golang错误处理如何与日志结合_Golang error日志记录模式

错误应逐层传递并添加上下文，仅在顶层处理时记录日志，使用errors.Wrap增强上下文，结合结构化日志输出error详情与追踪字段，避免敏感信息泄露，确保日志清晰、可追溯。

在Go语言开发中，错误处理和日志记录是保障系统可观测性和稳定性的关键环节。单纯返回error往往不足以定位问题，必须结合日志才能快速排查故障。合理的error与日志结合模式，既能保留调用上下文，又避免重复记录或信息缺失。

不重复记录，选择合适层级打印

常见误区是在每一层都对同一个error打日志，导致日志爆炸。正确做法是：只在错误不再向上返回、或进入最终处理分支（如HTTP响应）时记录日志。

• 底层函数出错，返回带有上下文的error，但不写日志
• 中间层通常只传递error，不做日志记录
• 顶层（如API handler、任务入口）统一记录error日志

例如Web服务中，handler收到error后写日志并返回500，而不是在数据库访问层就打印log。

使用errors.Wrap增强上下文

标准库的error缺乏堆栈信息，推荐使用pkg/errors或Go 1.13+的error wrapping机制，在传播error时添加上下文。

• 用errors.Wrap(err, "failed to read config")附加语义信息
• 保留原始error类型和堆栈（若使用pkg/errors）
• 在日志中通过%+v格式输出完整堆栈

这样日志里能看到“在哪一层出了什么问题”，而不只是“read file failed”。

结构化日志记录error详情

使用结构化日志库（如zap、logrus），将error和其他上下文字段一起输出，便于检索和分析。

• 记录error的同时带上request_id、user_id等追踪字段
• 把error本身作为独立字段传入，而非拼接进字符串
• 区分error级别：普通error用Error等级，严重故障用Fatal

zap示例：log.Error("failed to process order", zap.Error(err), zap.Int64("order_id", id))

避免敏感信息泄露

error可能包含路径、SQL、密钥等敏感内容，直接输出有风险。

• 对外暴露的error应净化，内部再记录完整版本
• 自定义error类型控制.Error()方法的输出内容
• 日志系统配置过滤规则，屏蔽特定关键词

比如数据库超时错误，对外返回“服务暂时不可用”，内部日志才记录具体SQL和参数。

基本上就这些。核心是：错误往上传，日志最后打，上下文要全，结构要清。不复杂但容易忽略。