# 知识库模块 - 错误码文档

> **版本**: v1.0  
> **最后更新**: 2026-01-09  
> **维护者**: 后端团队

> 🚧 Draft：本文件为最小占位，错误码需与 API/实现对齐后补充。

---

## 📋 概述

本文档定义知识库模块的错误码。

### 错误码规范

- **格式**: `KNOWLEDGE_BASE_{ERROR_TYPE}_{NUMBER}`
- **示例**: `KNOWLEDGE_BASE_VALIDATION_001`
- **HTTP 状态码**: 遵循 RESTful 标准

---

## 🎯 错误码分类

| 分类 | HTTP 状态码 | 说明 |
|------|-----------|------|
| 验证错误 | 400 | 请求参数验证失败 |
| 权限错误 | 403 | 无权限执行操作 |
| 资源错误 | 404 | 资源不存在 |
| 冲突错误 | 409 | 资源冲突 |
| 业务错误 | 422 | 业务逻辑错误 |
| 服务器错误 | 500 | 服务器内部错误 |

---

## ❌ 错误码清单（占位）

| 错误码 | 错误信息 | 场景 | 前端处理 |
|--------|---------|------|---------|
| `KNOWLEDGE_BASE_VALIDATION_001` | 字段不能为空 | 参数缺失 | 提示并高亮字段 |
| `KNOWLEDGE_BASE_PERMISSION_001` | 无权限 | 权限不足 | 禁用/隐藏操作 |
| `KNOWLEDGE_BASE_NOT_FOUND_001` | 资源不存在 | 访问不存在文档 | 显示“资源不存在” |
| `KNOWLEDGE_BASE_CONFLICT_001` | 资源冲突 | 重复创建 | 提示已存在 |
| `KNOWLEDGE_BASE_BUSINESS_001` | 业务规则不满足 | 权限过滤失败 | 显示业务规则说明 |
| `KNOWLEDGE_BASE_SERVER_001` | 服务器错误 | 未预期异常 | 显示通用错误提示 |
| `KNOWLEDGE_BASE_SITE_RESOLVE_FAILED` | 站点解析失败 | 站点配置错误或无权限 | 提示检查配置 |
| `KNOWLEDGE_BASE_DRIVE_RESOLVE_FAILED` | 文档库解析失败 | 无法访问默认文档库 | 提示检查权限 |
| `KNOWLEDGE_BASE_SEARCH_FAILED` | 搜索失败 | SharePoint 返回错误 | 提示稍后重试 |
| `KNOWLEDGE_BASE_UPLOAD_FAILED` | 上传失败 | SharePoint 上传异常 | 提示稍后重试 |
| `KNOWLEDGE_BASE_NOT_FOUND_001` | 文章不存在 | 请求不存在文章 | 提示资源不存在 |