用途:本技能介绍如何在 Go 中用 samber/oops 做结构化错误处理,把错误当作结构化数据,让每处错误携带足够上下文(领域、属性、堆栈),便于值班工程师定位问题。它是 Go 标准错误处理的直接替换方案。
主要能力:通过流式构建器链为错误添加结构化上下文,支持键值属性、自动堆栈捕获、机器可读错误码、与用户可见的公开消息分离、自定义提示、负责人、用户与租户上下文、trace/span ID、时间与耗时、附加 HTTP 请求或响应。属性随错误沿调用栈传递,APM 工具(Datadog、Loki、Sentry)可正确分组错误。
常用方法:.In("domain")、.Tags("a","b")、.Code("x")、.Public("msg")、.Hint("…")、.Owner("team/slack")、.With("k",v)、.WithContext(ctx,…)、.User(id,…)、.Tenant(id,…)、.Trace(id)、.Span(id)、.Time(t)、.Since(t)、.Duration(d)、.Request(req,体)、.Response(res,体)、oops.FromContext(ctx)。终结方法:.Errorf(format,args...)、.Wrap(err)、.Wrapf(err,format,args...)、.Join(...)、.Recover(fn) / .Recoverf(fn,format,args...)。
推荐用法:.Wrap 无需先判 nil,err 为 nil 时返回 nil;每个架构层在包边界用 Wrap/Wrapf 补充上下文;错误消息保持低基数,变量数据放入 .With() 属性而非消息字符串,避免破坏 APM 聚合;在 goroutine 边界使用 oops.Recover 将 panic 转为结构化错误。读取信息可实现 oops.OopsError 获取 Code、Domain、Tags、Context、Stacktrace,并用 oops.GetPublic(err, "fallback") 取用户可见消息。输出可用 %+v 打印堆栈、json.Marshal 记录或 slog 集成。
限制:本技能非完整文档,更多信息需查阅库文档与代码示例;Go 包事实优先参考 samber/cc-skills-golang@golang-pkg-go-dev,代码导航参考该仓库的 gopls 技能,Context7 仅作后备。未提供收费、价格与平台等信息。