用途:在应用范围内建立一致的错误处理机制,使错误可分类、可记录、可调试,并对客户端返回安全提示。
主要能力:提供错误分类(AppError 基类与 ValidationError、NotFoundError、UnauthorizedError、ForbiddenError 等子类);HTTP 状态码映射(如 400、401、403、404、500);错误处理中间件 errorHandler,区分可预期业务错误与编程错误;结构化日志(示例使用 winston,输出 JSON 并含时间戳与堆栈);安全客户端消息 getSafeErrorMessage,避免向客户端暴露堆栈;异步错误包装器 asyncHandler,配合路由使用;最佳实践清单与输出检查清单(自定义错误类、中间件、状态码映射、结构化日志、安全消息、异步包装、监控告警、错误码文档)。
使用方式:定义或引入上述错误类;在请求处理链末端挂载 errorHandler 中间件;用 asyncHandler 包裹异步路由处理函数;通过 logger 记录带上下文(path、method、requestId 等)的错误;对客户端仅返回 code、安全 message、details 与 trace_id。
适用场景:Node/TypeScript 后端服务的统一错误响应、日志与监控。
限制:资料未说明具体安装命令、依赖版本、框架完整接入步骤、收费与平台支持信息。