# 错误处理（精简版）

> 适用入口：`backend-main`

## 错误结构

- 必须包含稳定 `code`
- 可选 `i18nKey` 与 `params`
- 不返回堆栈给客户端

## 错误码约定

- 统一命名：`RESOURCE_NOT_FOUND` / `VALIDATION_ERROR`
- 同一错误码在全局复用，禁止重复语义

## 映射规则

- 校验失败 → `400`
- 未登录 → `401`
- 无权限 → `403`
- 资源不存在 → `404`
- 冲突/重复 → `409`
- 未知异常 → `500` + 统一告警日志