支持大文件

word/api/error-codes.md

@@ -0,0 +1,256 @@
+# 错误码说明
+
+本文档详细说明了 DeEarthX 应用中使用的错误码系统，帮助用户和开发者理解和排查错误。
+
+## 错误码格式
+
+错误码采用四位数字格式，第一位数字表示错误类别，后三位数字表示具体错误：
+
+- `1xxx`: 后端启动相关错误
+- `2xxx`: 网络相关错误
+- `3xxx`: 文件相关错误
+- `4xxx`: 系统相关错误
+- `9999`: 未知错误
+
+## 错误码详情
+
+### 1. 后端启动相关错误
+
+#### 1001
+
+**错误信息**: 后端服务启动失败
+
+**可能原因**:
+- 后端服务无法启动
+- 可能是权限问题
+- 可能是文件损坏
+- 可能是端口被占用
+
+**解决方案**:
+1. 检查 37019 端口是否被占用
+2. 检查后端服务是否正常
+3. 重启应用程序
+
+#### 1002
+
+**错误信息**: 后端服务端口被占用
+
+**可能原因**:
+- 37019 端口已被其他应用占用
+- 可能有其他 DeEarthX 实例在运行
+
+**解决方案**:
+1. 关闭占用 37019 端口的其他应用
+2. 检查是否有其他 DeEarthX 实例在运行
+3. 重启计算机后再试
+
+#### 1003
+
+**错误信息**: 后端服务连接失败
+
+**可能原因**:
+- 无法连接到后端服务
+- 后端服务可能未启动
+- 网络连接可能存在问题
+
+**解决方案**:
+1. 检查后端服务是否正在运行
+2. 检查网络连接是否正常
+3. 重启应用程序
+
+#### 1004
+
+**错误信息**: 后端服务响应错误
+
+**可能原因**:
+- 后端服务返回错误响应
+- 后端服务可能出现内部错误
+
+**解决方案**:
+1. 检查后端服务是否正常
+2. 重启后端服务
+3. 联系技术支持
+
+### 2. 网络相关错误
+
+#### 2001
+
+**错误信息**: 网络连接错误
+
+**可能原因**:
+- 网络连接出现问题
+- 网络不稳定
+- 网络中断
+
+**解决方案**:
+1. 检查网络连接是否正常
+2. 检查防火墙设置
+3. 稍后重试
+
+#### 2002
+
+**错误信息**: 网络连接超时
+
+**可能原因**:
+- 网络连接超时
+- 网络速度过慢
+- 目标服务器响应缓慢
+
+**解决方案**:
+1. 检查网络连接速度
+2. 稍后重试
+3. 检查目标服务器是否可访问
+
+#### 2003
+
+**错误信息**: 网络连接被拒绝
+
+**可能原因**:
+- 网络连接被拒绝
+- 目标服务器可能未运行
+- 防火墙可能阻止连接
+
+**解决方案**:
+1. 检查目标服务器是否正在运行
+2. 检查网络连接是否正常
+3. 检查防火墙设置
+
+### 3. 文件相关错误
+
+#### 3001
+
+**错误信息**: 文件未找到
+
+**可能原因**:
+- 文件不存在
+- 文件路径不正确
+- 文件可能被删除或移动
+
+**解决方案**:
+1. 确认文件路径是否正确
+2. 检查文件是否存在
+3. 重新上传文件
+
+#### 3002
+
+**错误信息**: 文件权限错误
+
+**可能原因**:
+- 没有文件操作权限
+- 文件可能被其他程序占用
+- 应用程序可能没有足够的权限
+
+**解决方案**:
+1. 检查文件权限设置
+2. 以管理员身份运行应用程序
+3. 检查文件是否被其他程序占用
+
+#### 3003
+
+**错误信息**: 文件格式错误
+
+**可能原因**:
+- 文件格式不正确
+- 文件可能损坏
+- 文件类型不符合要求
+
+**解决方案**:
+1. 确认文件格式是否正确
+2. 重新上传正确格式的文件
+3. 检查文件是否损坏
+
+#### 3004
+
+**错误信息**: 文件大小错误
+
+**可能原因**:
+- 文件大小不符合要求
+- 磁盘空间可能不足
+- 文件可能过大
+
+**解决方案**:
+1. 检查文件大小是否符合要求
+2. 压缩文件后再上传
+3. 检查磁盘空间是否充足
+
+### 4. 系统相关错误
+
+#### 4001
+
+**错误信息**: Java 未找到
+
+**可能原因**:
+- 系统中未安装 Java
+- Java 环境变量未配置
+- Java 版本可能不兼容
+
+**解决方案**:
+1. 安装 Java 17 或更高版本
+2. 配置 Java 环境变量
+3. 重启应用程序
+
+#### 4002
+
+**错误信息**: 磁盘空间不足
+
+**可能原因**:
+- 磁盘空间不足
+- 目标存储位置空间已满
+
+**解决方案**:
+1. 清理磁盘空间
+2. 选择其他存储位置
+3. 删除不必要的文件
+
+#### 4003
+
+**错误信息**: 内存不足
+
+**可能原因**:
+- 系统内存不足
+- 应用程序占用内存过多
+- 其他应用程序占用大量内存
+
+**解决方案**:
+1. 增加系统内存
+2. 关闭其他占用内存的应用程序
+3. 减少同时处理的任务数量
+
+### 5. 未知错误
+
+#### 9999
+
+**错误信息**: 未知错误
+
+**可能原因**:
+- 发生未知错误
+- 可能是应用程序内部错误
+- 可能是系统环境问题
+
+**解决方案**:
+1. 重启应用程序
+2. 检查系统日志
+3. 联系技术支持
+
+## 错误处理流程
+
+当应用遇到错误时，会：
+
+1. 生成相应的错误码和错误信息
+2. 在界面上显示错误信息和错误码
+3. 提供可能的解决方案
+4. 记录错误日志以便排查
+
+## 如何使用错误码
+
+当您遇到错误时：
+
+1. 查看错误信息和错误码
+2. 参考本文档中的解决方案尝试解决
+3. 如果问题仍然存在，请联系技术支持并提供错误码和详细的错误信息
+
+## 注意事项
+
+- 错误码仅用于参考，具体错误原因可能因环境不同而有所差异
+- 如遇到持续的错误，请检查系统环境和网络连接
+- 定期更新应用程序以获取最新的错误处理机制