使用结构化日志和错误上下文提升Go系统可观测性，通过zap等库输出JSON格式日志，结合request_id串联请求链路，在错误传播中用errors.Wrap或%w包装添加上下文，并在统一入口记录日志，实现高效问题追踪。
在Go语言开发中，错误处理和日志记录是保障系统可观测性的关键环节。单纯打印错误信息已经无法满足复杂系统的调试和监控需求。通过结构化日志和错误关联，可以显著提升问题排查效率。核心在于：使用结构化格式输出日志、携带上下文信息、并建立错误之间的因果链。
使用结构化日志格式
传统的字符串拼接日志难以解析和查询。结构化日志以键值对形式输出，通常采用JSON格式，便于机器解析和集成到ELK、Loki等日志系统。
推荐使用 zap 或 logrus 等支持结构化的日志库。
- 使用 zap.Sugar().Infow() 或 logrus.WithFields() 添加字段 - 关键字段包括：request_id、user_id、method、path、error_code 等 - 避免将结构体直接打印为字符串，应拆解为独立字段示例：
立即学习“go语言免费学习笔记（深入）”；
logger.Info("failed to process request",
"request_id", reqID,
"user_id", userID,
"error", err.Error())
携带上下文信息传递错误
Go 的原生 error 不支持上下文。使用 github.com/pkg/errors 或 Go 1.13+ 的 %w 包装机制，可以在不丢失原始错误的前提下附加信息。
- 在每一层调用中使用 errors.Wrap(err, "context message") 添加上下文 - 或使用 fmt.Errorf("msg: %w", err) 进行包装 - 保留堆栈信息有助于定位错误源头例如：
漂亮的企业网站。NET2.0出来了， 本次升级修改如下： 1、优化了3层结构。 2、优化了后台管理代码，增强了安全性能。 3、增加了系统名称及关键字管理。 4、增加了系统错误日志记录，自动生成Systemlog.log日志文件。 备注：本系统采用ASP.NET 2.O+ACCESS开发，请调试的朋友安装.NET2.0运行环境！ 网站内容 网站栏目包括 首页|企业简介|新闻中心|产品展示|公司展示|
if err != nil {
return errors.Wrap(err, "db query failed")
}
这样最终错误中会包含从数据库层到业务层的完整调用链。
关联错误与日志的唯一标识
在分布式系统中，单个请求可能经过多个函数或服务。通过引入唯一标识（如 request_id），可将分散的日志和错误串联起来。
- 在请求入口生成 request_id，并放入 context.Context - 各层日志都记录该 request_id - 错误发生时，确保日志中包含此 ID - 可结合 trace_id 实现跨服务追踪用法示例：
ctx := context.WithValue(r.Context(), "req_id", generateID())
// 日志中输出：
logger.Info("handler start", "request_id", getReqID(ctx))
统一错误记录与日志输出
避免重复记录或遗漏。建议在错误传播的最终处理点（如HTTP中间件）统一记录错误日志。
- 在中间件中 recover panic 并记录结构化错误日志 - 只对最终未处理的错误进行日志输出，防止重复 - 包含错误类型、消息、堆栈（可选）、request_id例如在HTTP handler中间件中：
defer func() {
if r := recover(); r != nil {
logger.Error("panic recovered",
"request_id", reqID,
"error", fmt.Sprintf("%v", r),
"stack", string(debug.Stack()))
}
}()
基本上就这些。结构化日志和错误关联不复杂，但容易忽略。关键是坚持使用上下文传递、统一格式输出、并用唯一ID串联全过程。这样出问题时，查日志就像顺藤摸瓜，清晰高效。
