DeEarthX-CE/word/api/error-codes.md

# 错误码说明

本文档详细说明了 DeEarthX 应用中使用的错误码系统，帮助用户和开发者理解和排查错误。

## 错误码格式

错误码采用四位数字格式，第一位数字表示错误类别，后三位数字表示具体错误：

- `1xxx`: 后端启动相关错误
- `2xxx`: 网络相关错误
- `3xxx`: 文件相关错误
- `4xxx`: 系统相关错误
- `9999`: 未知错误

## 错误码详情

### 1. 后端启动相关错误

#### 1001

**错误信息**: 后端服务启动失败

**可能原因**:
- 后端服务无法启动
- 可能是权限问题(不要安装在C盘哦~)
- 可能是文件损坏
- 可能是端口被占用

**解决方案**:
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. 如果问题仍然存在，请联系技术支持并提供错误码和详细的错误信息

## 注意事项

- 错误码仅用于参考，具体错误原因可能因环境不同而有所差异
- 如遇到持续的错误，请检查系统环境和网络连接
- 定期更新应用程序以获取最新的错误处理机制

## 其它

如果解决不了，请向QQ群反馈，你需要反馈（CE或者主版本群都可以）：
```
你好，我有XXX问题，错误码XXX
我的安装路径是XXX
环境是WindowsXXX，Java版本XXX
程序是XXX版本（CE或者主版本）
```