用途:为项目设计并落地错误处理与可观测性方案,覆盖错误分类、分层处理、结构化日志、重试、熔断、降级和错误上报。触发场景包括 try/catch 模式、重试逻辑、错误响应、熔断器、结构化日志;与错误处理或可观测性无关的任务应跳过。
主要能力与用法:提供按语言(JavaScript/TypeScript、Python、Go)的异常体系与处理范式,例如自定义 AppError 继承层级、Express 四参数全局错误中间件、Python 特定异常捕获、Go 使用 %w 包装并用 errors.Is/errors.As 判断。日志方面给出 pino 结构化 JSON 日志、通过 AsyncLocalStorage 传递关联 ID、日志级别约定(TRACE/DEBUG/INFO/WARN/ERROR/FATAL),并要求脱敏密码、令牌、PII、请求体等。还包含 React 错误边界、服务降级返回缓存或默认推荐、带抖动的指数退避重试(仅重试瞬态错误)、三态熔断器(closed/open/half-open)以及 Sentry 集成与用户可见错误消息映射。
限制与注意:资料未提供该技能的安装方式、配置参数或收费信息;示例中的阈值、超时和采样率均为示例值,需按实际环境调整。遵循反模式清单:避免空 catch、裸 except、生产用 console.log、记录敏感信息、无退避重试、对所有错误重试、外部调用无熔断、向用户暴露堆栈、缺少关联 ID、一个巨型 try/catch 等。