XGRIDS文档

附录-错误码列表

1. 软件调度层错误码（LCC_MANAGER_*，0x34041xxx / 0x24041xxx）

1.1 系统与资源

错误码名称含义
0x34041100LCC_MANAGER_UNKNOWN_ERR系统未知错误
0x34041000LCC_MANAGER_DISK_ERR磁盘空间不足
0x34041001LCC_MANAGER_GPU_ERRGPU 校验不通过（驱动/兼容性）
0x34041002LCC_MANAGER_APP_ERR程序组件缺失
0x34041021LCC_MANAGER_NO_AUTH权限未激活 / 场景数超限

1.2 扫描工程输入校验

错误码名称含义
0x34041003LCC_MANAGER_SCAN_DATA_ERR扫描工程不存在（路径错误）
0x34041004LCC_MANAGER_PROJEC_DATA_ERR缺少 project_data 目录
0x34041005LCC_MANAGER_HBC_ERR缺少 HBC/xbin 文件或为空
0x34041006LCC_MANAGER_ROSBAG_ERRHBC 文件格式/内容错误
0x34041007LCC_MANAGER_POSES_ERR缺少 poses.csv
0x34041008LCC_MANAGER_DEVICE_INFO_ERR缺少 project_data/log/device_info.txt
0x34041009LCC_MANAGER_PROJECT_JSON_ERR缺少 project.json
0x34041010LCC_MANAGER_K1_SYETEM_VERSION_ERRK1 固件版本低于 V1.2.0

1.3 融合 / 空地 / 航拍校验

错误码名称含义
0x34041014LCC_MANAGER_RTK_CONTROL_POINTS_ERR缺少控制点/RTK 数据（地图融合必需）
0x34041015LCC_MANAGER_RTK_POINTS_ERR控制点/RTK 不足以满足融合
0x34041016LCC_MANAGER_DEVICETYPE_ERR融合数据来自不同设备类型
0x34041017LCC_MANAGER_LIDAR_TYPE_ERR融合数据雷达类型不一致
0x34041018LCC_MANAGER_PROJECT_MAX_ERR融合工程数超限（>50）
0x34041019LCC_MANAGER_MAP_FUSION_MAX_LIMIT融合总扫描时长超限（>200 分钟）
0x34041022LCC_MANAGER_DRONE_RTK_ERR空地融合图片 RTK 占比 < 80%
0x34041025LCC_MANAGER_DRONE_IMAGE_COUNT_ERR无人机图片数量/格式错误（100~10000，JPG/JPEG）
0x34041026LCC_MANAGER_DRONE_IMAGE_PX_ERR无人机图片分辨率 < 1024×768
0x34041027LCC_MANAGER_DRONE_IMAGE_ERR无人机图片分辨率不一致

1.4 高清补拍

错误码名称含义
0x34041023LCC_MANAGER_HD_IMAGE_ERR高清补拍图片分辨率不一致
0x34041024LCC_MANAGER_HD_IMAGE_COUNT_ERR高清补拍数量错误（20~1000，JPG/JPEG/PNG）
0x3404102DLCC_MANAGER_HD_PATH_NOT_FOUND_ERR高清补拍目录不存在
0x3404102ELCC_MANAGER_HD_PATH_INVALID_ERR高清补拍路径非法（含逗号等）

1.5 生命周期 / 取消 / 队列

错误码名称含义
0x34041020LCC_MANAGER_USER_STOP_ERR用户手动取消重建
0x34041029LCC_MANAGER_TASK_CANCELLED_ERR任务因同一 jobId 下其它阶段失败被级联取消
0x3404102ALCC_MANAGER_QUEUE_REJECT_ERR队列层放弃：参数/配置确定性失败，重试无意义

1.6 高斯点 / 设备能力

错误码名称含义
0x3404102BLCC_MANAGER_GAUSSIAN_POINT_MAX_ERR高斯点数超过设备/质量允许上限
0x3404102CLCC_MANAGER_GAUSSIAN_POINT_RANGE_ERRmaximumGaussianPoint 超出 8–50 合法范围
0x3404102FLCC_MANAGER_DEVICE_UNSUPPORTED_FEATURE_ERR当前设备不支持该功能（如 F1 不支持高清补拍）
0x34041028LCC_MANAGER_VIDEO_INPUT_ERR视频重建输入校验失败（探测/帧率/图片不合规）

1.7 调度层警告（0x24041xxx，不阻断重建）

错误码名称含义
0x24041000LCC_MANAGER_SCANTIME_WARN扫描时长与视频时长差 > 2 分钟
0x24041001LCC_MANAGER_CPU_USE_WARN启动时 CPU 负载 > 50%
0x24041201LCC_REBUILD_CONERNT_ERRLCC 数据转换处理失败

2. 重建层错误码（LCC_ALG_*）

2.1 通用重建错误

错误码名称退出码含义
0x34040000LCC_ALG_UNKNOWN_ERR999算法未知错误（崩溃/未细化）
0x34040009LCC_ALG_NO_AUTH_ERR9初始化异常/授权校验超时
0x34040040LCC_ALG_APP_ERR64内部参数错误
0x34040041LCC_ALG_INPUT_ERR65输入缺失或错误（数据完整性）
0x34040042LCC_ALG_DISK_ERR66工程目录已满/硬盘异常
0x34040043LCC_ALG_PROJECT_DATA_ERR67工程文件损坏
0x34040060LCC_ALG_MEMORY_SHORT_ERR96系统内存不足
0x34040061LCC_ALG_DATA_TO_LARGE_ERR97数据规模过大（算法内部限制）
0x34040070LCC_ALG_UNKNOWN_GPU_ERR112未知 GPU 调用错误（驱动不稳定）
0x34040071LCC_ALG_GPU_MEM_ERR113GPU 显存不足

2.2 采集 / 位姿 / 相机

错误码名称退出码含义
0x34040100LCC_ALG_PROJECT_DEMAGED_ERR12/16/14工程文件损坏
0x34040101LCC_ALG_LIO_ERR10LIO/离线 SLAM 位姿解算错误
0x34040102LCC_ALG_CAMERA_SYNC_ERR20外置相机同步失败
0x34040103LCC_ALG_CAMERA_DAMAGED_ERR17外置相机文件损坏
0x34040104LCC_ALG_SCAN_SHORT_ERR16扫描过程静止/运动路径过短
0x34040105LCC_ALG_DRONE_NOT_RTK18无人机图像无 RTK 信息或损坏
0x34040106LCC_ALG_3DGS_DRONE_IMAGE_ERR17输入的无人机图像损坏
0x34040107LCC_ALG_3DGS_PAGE_LOCKED_MEMORY_ERR63(0x3F)页锁定内存错误
0x34040108LCC_ALG_3DGS_NO_GAUSSIAN_PRIMITIVES_ERR103DGS 生成中未检测到高斯原语
0x34040109LCC_ALG_3DGS_UNSUPPORTED_GNSS_ERR10检测到不支持的 GNSS 类型

2.3 融合 / SfM / 3DGS

错误码名称退出码含义
0x34040200LCC_ALG_MAP_FUSION_ERR / LCC_ALG_MAP_FUSION_RTK_ERR28 / 26地图融合错误（RTK 信号不足或控制点错误）
0x34040201LCC_ALG_3DGS_MAP_RTK_POINT_ERR13地图合并失败（建议优先 RTK 或覆盖全部控制点）
0x34040202LCC_ALG_3DGS_CONTROL_MAP_ALIG_ERR27地图对齐错误（控制点错误）
0x34040203LCC_ALG_IMAGE_SCAN_ENV_ERR16图像注册失败（扫描环境/手法问题）
0x34040204LCC_ALG_3DGS_DATA_TOO_SHORT17扫描时长过短 / 解码失败
0x34040205LCC_ALG_3DGS_IMAGES_TO_LESS16输入图像太少

2.4 重建警告（0x24040xxx，不阻断重建）

错误码名称含义
0x24040100LCC_ALG_MAP_FUSION_WARN地图融合部分数据关联不足（重叠区可能错位/重影）
0x24040101LCC_ALG_DRONE_IMAGE_LSOT_WARN无人机部分图像关联不足导致部分区域缺失
0x24040102LCC_ALG_IMAGE_LOST_WARN高清补拍部分图像重定位失败
0x24040103LCC_ALG_3DGS_LIMT_WARN3DGS 触发显存上限，质量下降
0x24040104LCC_ALG_3DGS_DRONE_GNSS_LESS航拍 GNSS 信息不足（结果可能缺绝对坐标）

3. 空间识别 错误码（0x33xxxxxx）

仅在启用 空间识别功能（语义分割/单体化/OCR/增强/Scan2BIM 等）时出现。

3.1 公共错误码（所有空间识别共用）

错误码名称含义
0x33001001LCC_AI_COMMON_INIT_ERR初始化 AI 推理环境失败
0x33001002LCC_AI_COMMON_MODEL_FILE_ERR无法打开 AI 模型文件
0x33001003LCC_AI_COMMON_CUDA_ERRCUDA/GPU 后端不可用
0x33001004LCC_AI_COMMON_OUTPUT_NOT_WRITABLE_ERR输出路径不可写
0x33001005LCC_AI_COMMON_DISK_SPACE_ERR输出路径磁盘空间不足
0x33001006LCC_AI_COMMON_USER_CANCEL_ERR用户取消
0x33001007LCC_AI_COMMON_IMAGE_FILE_ERR无法打开输入图像文件
0x33001008LCC_AI_COMMON_IMAGE_FOLDER_ERR无法打开输入图像文件夹
0x33001009LCC_AI_COMMON_IMAGE_INVALID_ERR图像输入异常
0x3300100ALCC_AI_COMMON_INFER_ERR执行推理失败
0x3300100BLCC_AI_COMMON_BATCH_PARTIAL_ERR批处理部分输入失败

4. 非规范码（就地短码 & 状态词）

4.1 就地短码

值场景
0x00001设备不支持该功能（F1 高清补拍/融合）
0x00002高斯点数超限（就地旧码，现规范为 0x3404102B）
0x00003高斯点数范围非法（就地旧码，现规范为 0x3404102C）
0X10001CheckSupportDevice 不通过：该设备暂不支持
0x34041404C1 设备缺少 LiteCode，不支持

4.2 纯状态词（语义标签，非错误码）

值场景
DOWNLOAD_FAILEDcloud 输入对象存储下载失败
UPLOAD_FAILEDoutput 结果上传对象存储失败
USER_STOP用户手动停止
STALE_STATE任务卡死被 stop 强制置终态
NODE_BUSY / ALREADY_RUNNING节点忙/任务已在运行（出现在启动响应，非 buildErrCode）

5. 常见失败速查（场景 → 错误码/文案）

现象可能错误码/文案处理建议
启动即 Http authentication failedHTTP 403检查 accessKey 与服务端配置一致
单地图忙时 LAST TASK STILL IN PROGRESSbizCode 1传 jobQueueEnabled:1 排队，或等待当前任务结束
输入目录打不开/找不到0x34041003 或 No such file or directory检查容器内挂载路径、逗号
缺少 project_data / HBC / poses.csv / project.json0x34041004~0x34041009检查扫描工程文件完整性
融合无 RTK/控制点0x34041014 / 0x34041015融合场景需有效 RTK 或控制点
融合设备/雷达不一致0x34041016 / 0x34041017融合数据须来自同型号设备
无人机图片 < 100 张0x34041025至少 100 张 JPG/JPEG
高斯点超限0x3404102B / 文案 "cannot exceed N"降低 maximumGaussianPoint 或换更大显存
高斯点范围非法0x3404102C传 8–50
显存不足0x34040071 / 0x34041001降低质量/点数或释放 GPU
系统内存不足0x34040060关闭后台应用或降低质量
数据规模过大0x34040061减少输入数据或降低质量
用户取消0x34041020属主动停止，可 resume 续跑
上传失败UPLOAD_FAILED（buildErrLog 有具体原因）检查对象存储凭证/网络
下载失败DOWNLOAD_FAILED检查 cloudInput 端点/桶/凭证