SuperAPI AI 工具集

handling-api-errors

编程与开发

查看项目

更新于 10-15 23:26

技能介绍

用途:为 Web API 建立统一的错误处理机制,将框架异常、校验失败、数据库错误和上游服务失败转换为一致、机器可读的响应,并使用合适的 HTTP 状态码。

主要能力:按 RFC 7807 定义错误响应结构(type、title、status、detail、instance);为各类错误创建类型化错误类,如 ValidationError(400)、AuthenticationError(401)、AuthorizationError(403)、NotFoundError(404)、ConflictError(409)、RateLimitError(429);实现集中式错误中间件,统一映射状态码与响应体,避免原始堆栈泄露给客户端;把框架校验失败整理为含 field、message、code 的字段级错误数组;按环境区分错误详情,开发/预发返回堆栈和内部错误码,生产环境仅服务端记录完整错误;集成 Sentry、Bugsnag 或 Rollbar,捕获 5xx 并归组;处理进程级未捕获异常与未处理 Promise 拒绝;编写测试验证各错误类型的状态码、响应体和生产模式下隐藏堆栈。

使用方式:资料未提供安装命令与具体调用代码,需参考技能目录下 references/implementation.md 等文件;输出文件包括 src/errors/ 下的错误类与错误码注册表、src/middleware/error-handler.js、src/errors/formatters.js、src/config/error-config.js 及 tests/errors/ 测试。

适用场景:使用 Express、FastAPI、Spring Boot、Gin 等支持中间件/错误处理器的框架,并配合结构化日志与错误监控服务的 API 项目。

限制:需具备相应框架、结构化日志库和错误监控服务;未提供具体实现代码、价格或平台支持信息,落地细节以技能内 reference 文档为准。