Go 微服务错误追踪链路需统一错误封装、透传 traceID、集成 OpenTelemetry：定义带 traceID/ 业务码的错误结构，通过 context 贯穿调用链，用 span.RecordError 自动标注错误，结构化日志对齐 trace 字段，并按 traceID 聚合告警。
为 Go 微服务构建错误追踪链路，核心是让一次请求中的所有错误能沿调用链向上透传、关联并可定位——不是只记录“哪里 panic 了”，而是清楚知道“谁调用了谁、在哪个环节出错、上下文是什么”。关键在于统一错误封装、传播 trace ID、集成结构化日志与分布式追踪系统（如 OpenTelemetry）。
统一错误建模：带上下文的错误类型
避免直接用 errors.New 或 fmt.Errorf 返回裸错误。定义一个可扩展的错误结构，内嵌 traceID、spanID、服务名、时间戳和业务码：
- 使用
github.com/pkg/errors或原生fmt.Errorf的 %w 包装实现错误链路； - 在中间件或 RPC 客户端入口自动注入当前 traceID（从 context 或 HTTP header 中提取）；
- 错误创建时主动附加关键字段，例如：
NewError(ErrCodeDBTimeout).WithTag("sql", stmt).WithTraceID(ctx.Value("trace_id").(string))。
Context 传递 traceID 并贯穿整个调用链
Go 的 context.Context 是天然载体。所有跨 goroutine、HTTP、gRPC、消息队列的操作，都必须将携带 traceID 的 context 向下传递：
- HTTP 入口从
X-Trace-ID或traceparentheader 解析并注入 context； - gRPC 调用前用
metadata.AppendToOutgoingContext把 traceID 写入 metadata； - 数据库操作、缓存访问、异步任务 启动等，都要确保 context 未丢失——尤其注意 goroutine 启动时别用空 context。
集成 OpenTelemetry 实现自动错误标注
OpenTelemetry Go SDK 可在 span 中自动标记 error 属性，配合 collector 上报到 Jaeger / Tempo / Grafana：
- 当捕获到非 nil 错误时，调用
span.RecordError(err)，它会自动设置status.code = ERROR和error.type等属性； - 确保 span 的 name 能体现操作语义（如
"user.service.GetProfile"），而非泛泛的"http.handler"； - 错误日志输出时，用结构化 logger（如
zerolog或zap）把 traceID、spanID、error stack、业务参数一并写入，方便日志与 trace 关联查询。
错误聚合与告警：按 trace 维度收敛问题
单个 trace 内可能有多个服务报错，但根源往往只有一个。需在可观测平台中支持按 traceID 聚合错误事件：
- 配置 Loki 或 Datadog 日志查询时，用
{traceID="xxx"}拉取整条链路日志； - 在 Jaeger 中点击 error 标签的 trace，直接跳转到首段失败的 span；
- 告警规则避免“每错即报”，改为“5 分钟内同一 trace 出现 ≥2 个 ERROR span”或“下游服务 error rate 突增 + 上游 traceID 高频出现”，减少噪音。
基本上就这些。不复杂但容易忽略的是：错误是否真的随 context 流动、日志字段是否对齐 trace 系统、以及开发时有没有习惯性用 log.Printf 替代结构化 logger 输出错误上下文。
