SuperAPI AI 工具集

hello-errors

编程与开发

查看项目

更新于 10-15 22:12

技能介绍

用途:在编写错误处理、异常管理、日志记录、监控、重试与降级相关代码时,按统一规范实施,避免静默失败与信息泄露。

主要能力与规范要点: 编码前先分类可预期错误(验证失败、资源不存在)与不可预期错误(系统故障、第三方宕机)。可预期错误正常处理并返回友好信息;不可预期错误记录日志并返回通用错误。不要用 try-catch 包裹所有代码,只捕获能处理的异常。

结构化错误:统一格式 { code, message, details? };HTTP 状态码准确,4xx 为客户端错误、5xx 为服务端错误;不向用户暴露堆栈、SQL、文件路径等内部细节;错误码可枚举,便于前端处理。

日志规范:使用结构化日志(JSON),包含 timestamp、level、context;错误日志包含堆栈、请求 ID、用户上下文;密码、token、身份证等敏感信息脱敏后再记录;级别为 error(必须处理)> warn(需关注)> info(正常流程)> debug(调试)。

恢复策略:外部调用设置超时并重试(指数退避,最多 3 次);关键操作做幂等设计以支持安全重试;优雅降级,部分功能不可用不影响核心流程;断路器在连续失败超过阈值时快速失败。

交付检查:错误响应格式统一;不暴露内部细节;外部调用有超时设置;敏感信息已脱敏;无静默失败(无空 catch 吞错误、无静默降级、无静默回退)。

使用方式与限制:资料未提供具体安装命令、代码示例或平台信息,暂未提供。