Go 错误处理与告警设计：errors 包装、日志字段与告警降噪

错误没有分类时，告警只能按 ERROR 日志数量触发，很容易出现误报、刷屏和无法分派责任人。Go 错误处理要让机器也能读懂错误类型。

解决方案思路

底层保留 sentinel error 或 typed error，上层用 fmt.Errorf("%w") 包装上下文；统一出口用 errors.Is/As 分类，再写入 error_type、severity、owner 等字段，并让告警按错误类型聚合去重。

核心代码示例

if errors.Is(err, context.DeadlineExceeded) {
    metricErrors.WithLabelValues("timeout").Inc()
    slog.Warn("downstream timeout", "error_type", "timeout", "err", err)
    return fallback()
}

运行逻辑

错误发生后先携带业务上下文向上返回，统一出口负责分类。日志记录细节，指标负责聚合，告警系统按 error_type、route 和 owner 去重后再通知值班人。

重点观察指标

• error_type 维度错误率
• 告警压缩率和重复告警数量
• MTTA、MTTR 和未处理告警积压

常见误区

• 每层都打印错误导致重复日志
• 直接字符串匹配 err.Error
• 告警规则没有 owner 和降噪策略

参考方案

• errors 官方文档
• Go log/slog 官方文档

落地检查

• 字段、指标和 Span 名称要稳定，便于长期聚合。
• 上线前先在灰度环境验证采集成本和数据量。
• 告警必须能指向 owner、排查入口和回滚方案。