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