hello-errors
Installation
SKILL.md
错误处理相关代码必须遵循以下规范。
编码前
先分类可预期错误 vs 不可预期错误,再写代码。
错误分类
- 可预期错误(验证失败、资源不存在)→ 正常处理,返回友好信息
- 不可预期错误(系统故障、第三方宕机)→ 记录日志,返回通用错误
- 不要用 try-catch 包裹所有代码——只捕获你能处理的
结构化错误
- 统一错误格式:
{ code, message, details? } - HTTP 状态码准确:4xx 客户端错误,5xx 服务端错误
- 不暴露内部实现细节(堆栈、SQL、文件路径)给用户
- 错误码可枚举,便于前端处理