SuperAPI AI 工具集

common-error-handling

编程与开发

查看项目

更新于 10-16 05:51

技能介绍

用途:为 API、领域与基础设施三层提供统一的错误处理标准,优先级 P1(HIGH),用于定义错误设计、响应结构、错误码以及错误边界的放置位置。

主要能力与分层约定:API 层负责将领域错误全局映射为 HTTP 响应;领域层只抛出纯业务错误,不出现 HTTP 状态码;基础设施层负责包装第三方异常,不把原始数据库错误泄漏到 API。API 必须返回标准化的 JSON 信封结构,具体实现示例见资料中的标准错误响应形状。

错误机制:包装错误时添加上下文,例如 fmt.Errorf("process: %w", err) 或 new Error('msg', { cause });仅在原始错误泄漏敏感细节时才替换错误。错误码使用 SCREAMING_SNAKE_CASE 形式的标识,例如 ORDER_PAYMENT_FAILED。

反模式:禁止吞掉错误,不得使用空 catch 或静默忽略失败,必须显式记录日志、包装、重新抛出或在正确边界处映射;不得在 API 响应中暴露堆栈跟踪;校验失败应使用带具体细节的 400,而不是笼统的 500。

参考:API 错误契约、失败处理检查清单。

限制:资料未提供具体代码示例、安装命令、平台或收费信息,暂未提供。