该技能用于指导开发者实现健壮、可维护的错误处理,提供清晰反馈与恢复机制。主要能力包括:上下文专属异常类型(不建基类,避免耦合)、异常与 Result 模式的取舍、边界输入验证(如 zod)、领域验证、重试逻辑、熔断器、降级回退值、结构化日志,以及 Hono 的全局 HTTP 错误处理。
核心原则:用异常而非返回码;错误不返回 null;异常携带丰富上下文;预期业务失败用 Result 模式,意外错误与基础设施故障用异常;在系统边界做验证;日志带关联 ID;瞬时故障重试;外部服务用熔断器。
使用方式:按资料中的 TypeScript 示例定义各上下文自己的错误类,在用例中抛出带上下文的异常,用 withRetry 包装可重试操作,用 CircuitBreaker 保护外部调用,在 Hono 的 app.onError 中按错误类型映射 400/404/500 响应。
适用场景:模块化单体、Clean Architecture 分层、后端用例与仓储、外部服务调用。限制:资料未提供安装命令、版本要求、收费信息或具体平台支持范围;完整后端实现示例需参考 backend-engineer 技能。