hello-errors

错误处理相关代码必须遵循以下规范。

编码前

先分类可预期错误 vs 不可预期错误，再写代码。

错误分类

• 可预期错误（验证失败、资源不存在）→ 正常处理，返回友好信息
• 不可预期错误（系统故障、第三方宕机）→ 记录日志，返回通用错误
• 不要用 try-catch 包裹所有代码——只捕获你能处理的

结构化错误

• 统一错误格式：{ code, message, details? }
• HTTP 状态码准确：4xx 客户端错误，5xx 服务端错误
• 不暴露内部实现细节（堆栈、SQL、文件路径）给用户
• 错误码可枚举，便于前端处理

日志规范

• 结构化日志（JSON），包含 timestamp、level、context
• 错误日志包含：堆栈、请求 ID、用户上下文