Skip to content

错误码说明

本文档详细说明了 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. 如果问题仍然存在,请联系技术支持并提供错误码和详细的错误信息

注意事项

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