--- title: 错误码 description: "错误码定义存放路径：\"${INSTALL_DIR}/include/ge/llm_error_codes.h\"和\"${INSTALL_DIR}/include/llm_datadist/llm_datadist.h\"。${INSTALL_DIR}请替换为CANN软件安装后文件存储路径。以root用户安装为例，安装后文件默认存储路径为：/usr/local/Ascend/cann。" url: https://www.hiascend.com/document/detail/zh/canncommercial/latest/others/llmdatadistdev/llmc_42_0041.html sourcePath: /source/zh/canncommercial/900/others/llmdatadistdev/llmc_42_0041.html indexId: eeca662afa5775d32905590983d2b16f9fc16b81d761bc6f16549787d0093a3869 --- # 错误码 错误码定义存放路径："${INSTALL_DIR}/include/ge/llm_error_codes.h"和"${INSTALL_DIR}/include/llm_datadist/llm_datadist.h"。${INSTALL_DIR}请替换为CANN软件安装后文件存储路径。以root用户安装为例，安装后文件默认存储路径为：/usr/local/Ascend/cann。 错误码是通过如下宏定义的。 ``` namespace ge { GE_ERRORNO_DEFINE(0b01, 0b01, 0b000, 8, 11, LLM_WAIT_PROC_TIMEOUT, 1); GE_ERRORNO_DEFINE(0b01, 0b01, 0b000, 8, 11, LLM_KV_CACHE_NOT_EXIST, 2); GE_ERRORNO_DEFINE(0b01, 0b01, 0b000, 8, 11, LLM_REPEAT_REQUEST, 3); GE_ERRORNO_DEFINE(0b01, 0b01, 0b000, 8, 11, LLM_REQUEST_ALREADY_COMPLETED, 4); GE_ERRORNO_DEFINE(0b01, 0b01, 0b000, 8, 11, LLM_PARAM_INVALID, 5); GE_ERRORNO_DEFINE(0b01, 0b01, 0b000, 8, 11, LLM_ENGINE_FINALIZED, 6); GE_ERRORNO_DEFINE(0b01, 0b01, 0b000, 8, 11, LLM_NOT_YET_LINK, 7); GE_ERRORNO_DEFINE(0b01, 0b01, 0b000, 8, 11, LLM_ALREADY_LINK, 8); GE_ERRORNO_DEFINE(0b01, 0b01, 0b000, 8, 11, LLM_LINK_FAILED, 9); GE_ERRORNO_DEFINE(0b01, 0b01, 0b000, 8, 11, LLM_UNLINK_FAILED, 10); GE_ERRORNO_DEFINE(0b01, 0b01, 0b000, 8, 11, LLM_NOTIFY_PROMPT_UNLINK_FAILED, 11); GE_ERRORNO_DEFINE(0b01, 0b01, 0b000, 8, 11, LLM_CLUSTER_NUM_EXCEED_LIMIT, 12); GE_ERRORNO_DEFINE(0b01, 0b01, 0b000, 8, 11, LLM_PROCESSING_LINK, 13); GE_ERRORNO_DEFINE(0b01, 0b01, 0b000, 8, 11, LLM_DEVICE_OUT_OF_MEMORY, 14); GE_ERRORNO_DEFINE(0b01, 0b01, 0b000, 8, 11, LLM_PREFIX_ALREADY_EXIST, 15); GE_ERRORNO_DEFINE(0b01, 0b01, 0b000, 8, 11, LLM_PREFIX_NOT_EXIST, 16); GE_ERRORNO_DEFINE(0b01, 0b01, 0b000, 8, 11, LLM_SEQ_LEN_OVER_LIMIT, 17); GE_ERRORNO_DEFINE(0b01, 0b01, 0b000, 8, 11, LLM_NO_FREE_BLOCK, 18); GE_ERRORNO_DEFINE(0b01, 0b01, 0b000, 8, 11, LLM_BLOCKS_OUT_OF_MEMORY, 19); GE_ERRORNO_DEFINE(0b01, 0b01, 0b000, 8, 11, LLM_CACHE_INCOMPATIBLE, 20); GE_ERRORNO_DEFINE(0b01, 0b01, 0b000, 8, 11, LLM_CACHE_KEY_ALREADY_EXIST, 21); GE_ERRORNO_DEFINE(0b01, 0b01, 0b000, 8, 11, LLM_COPY_CACHE_FAILED, 22); GE_ERRORNO_DEFINE(0b01, 0b01, 0b000, 8, 11, LLM_CACHE_ID_ALREADY_EXIST, 23); GE_ERRORNO_DEFINE(0b01, 0b01, 0b000, 8, 11, LLM_EXIST_LINK, 24); GE_ERRORNO_DEFINE(0b01, 0b01, 0b000, 8, 11, LLM_FEATURE_NOT_ENABLED, 25); } // namespace ge ``` 具体错误码含义如下。 | 错误码 | 含义 | 可能原因 | 是否可恢复 | 解决办法 | | --- | --- | --- | --- | --- | | 4294967295 | failed! | \- | 否 | 保留现场，获取Host/Device日志，并备份（Device日志需到宿主机进行port导回）。 | | 1343270913 | request wait to be processed timeout! | 等待组batch超时。 超时时间内未得到调度。 | 是 | 上层调用complete进行处理。 上层控制负载。 | | 1343270914 | KV is not exist! | 增量从全量侧获取KV，但是KV不存在。 | 是 | 检查clusterid与req\_id是否正确。 检查是否是Prompt超时，确认是否KV已经被释放。 检查是否存在重复拉取。 | | 1343270915 | repeat request! | 单次迭代中，多次调用同一个req\_id。 | 是 | 检查是否存在重复调用。 | | 1343270916 | request already complete! | 调度到的时候，上层已经发送了complete。 | 是 | 排查是否调用了未经处理的token的complete操作。 | | 1343270917 | Parameter's invalid! | 无效参数，包含LLM & GE的参数校验，需要通过日志确认具体原因，一般在调测阶段发生。 | 是 | 基于日志排查错误原因。 | | 1343270918 | llm engine finalized! | 调度到的时候，上层已经发送了Finalize。 | 否 | 上层调用时候排查是否退出前未完成所有请求的处理。 | | 1343270919 | decoder cluster is no link with prompt! | Decode未与Prompt建联。 | 是 | 上层排查Decode与Prompt建联情况。 | | 1343270920 | decoder cluster is already linked with prompt cluster! | Decode与Prompt已经建联。 | 是 | 上层排查Decode与Prompt建联情况。 | | 1343270921 | decoder cluster link with prompt cluster failed! | Decode与Prompt建联失败。 | 是 | LinkClusters API返回值为该错误码时，需要查看API出参中每个cluster的建联结果。 LinkClusters API出参rets中存在该错误码时，需要排查Cluster之间的网络连接。 建链失败时，会自动回滚，保证资源未被异常占用。 | | 1343270922 | decoder cluster unlink with prompt cluster failed! | Decode与Prompt断链失败。 | 是 | LinkClusters API返回值为该错误码时，需要查看API出参中每个cluster的断链结果。 LinkClusters API出参rets中存在该错误码时，需要排查Cluster之间的网络连接。 断链失败时，不回滚。 | | 1343270923 | decoder cluster notify prompt cluster do unlink failed! | Decode通知Prompt断链失败。 | 是 | 排查Decode与Prompt之间的网络连接。 主动调用Prompt侧的UnlinkClusters API清理残留资源。 | | 1343270924 | cluster num exceed limit! | API中一次性传入clusters超出上限，当前上限为16。 | 是 | 排查API传入参数，clusters数量不能超过16 | | 1343270925 | link is current processing, try again later! | 当前link和unlink正在执行。 | 是 | 请稍后再试。 | | 1343270926 | device out of memory! | 全量KV Cache内存不足。 | 是 | 增量拉完kv，再调用LLMReqComplete结束请求。 | | 1343270927 | Prefix has already existed. | 公共前缀已经存在。 | 是 | 不用重复下发相同公共前缀的请求。 | | 1343270928 | Prefix does not exist. | 公共前缀不存在。 | 是 | 下发前，重新生成公共前缀。 | | 1343270929 | Sequence length exceed limit. | PagedAttention场景下句子长度超过了block空间大小。 | 是 | 排查API传入参数，请求句子长度不能超过block\_num\*block\_size。 | | 1343270930 | No free block. | 系统不存在free block。 | 是 | 上层可选择重计算或者释放已有的请求。 | | 1343270931 | Block is out of memory. | 预申请Blocks内存不足。 | 是 | 需额外检查数据面mbuf内存总大小配置是否合理。 |