# IT 运营 - 错误码

> **版本**: v0.1  
> **最后更新**: 2026-03-10  
> **维护者**: 后端团队

---

## ✅ 机器读取区（必填）

### 错误码清单

| 错误码 | HTTP 状态 | i18n Key | 说明 |
|--------|-----------|----------|------|
| `CLOUD_COST_PROVIDER_NOT_CONNECTED` | 400 | `cloudCost.errors.providerNotConnected` | 云厂商账号未接入或不可用 |
| `CLOUD_COST_SYNC_RUNNING` | 409 | `cloudCost.errors.syncRunning` | 已有同步任务在执行 |
| `CLOUD_COST_PERIOD_INVALID` | 422 | `cloudCost.errors.periodInvalid` | 账期参数非法 |
| `CLOUD_COST_BUDGET_NOT_FOUND` | 404 | `cloudCost.errors.budgetNotFound` | 预算配置不存在 |
| `CLOUD_COST_AI_REPORT_NOT_READY` | 409 | `cloudCost.errors.aiReportNotReady` | AI 报告尚未生成完成 |
| `CLOUD_COST_DATA_NOT_READY` | 409 | `cloudCost.errors.dataNotReady` | 指定账期数据尚未准备完成 |
| `CLOUD_COST_EXPORT_LIMIT_EXCEEDED` | 400 | `cloudCost.errors.exportLimitExceeded` | 导出范围过大 |

---

## 🧭 人类阅读区（可选）

### 设计原则

- 错误码稳定，面向机器可读。
- 返回 `i18n key + details`，不直接返回硬编码中文文本。
- AI 报告相关错误与账单同步相关错误分开管理，避免前端无法正确提示。