---
title: LLMStatusCode
description: "LLMException中status_code对应的枚举类，枚举值及解决方法如下表。"
url: https://www.hiascend.com/document/detail/zh/canncommercial/latest/API/hixlug/llmprv2_42_0067.html
sourcePath: /source/zh/canncommercial/900/API/hixlug/llmprv2_42_0067.html
indexId: 951c2669d14c39b3bc2e6f8bebbf8092413c60250006ed69931247afd841368261
---
# LLMStatusCode

LLMException中status_code对应的枚举类，枚举值及解决方法如下表。

| 枚举值 | 含义 | 是否可恢复 | 解决办法 |
| --- | --- | --- | --- |
| LLM\_SUCCESS | 成功 | 无 | 无 |
| LLM\_FAILED | 通用失败 | 否 | 重启机器或容器； 保留现场，获取Host/Device日志，并备份。 |
| LLM\_PARAM\_INVALID | 参数错误 | 是 | 基于日志排查错误原因。 |
| LLM\_KV\_CACHE\_NOT\_EXIST | KV不存在 | 是 | 检查对应全量侧报错日志中的请求是否完成。 检查是否存在重复拉取。 检查标记目标cache的参数是否错误。 |
| LLM\_REPEAT\_REQUEST | 重复请求 | 是 | 检查是否存在重复调用。 |
| LLM\_NOT\_YET\_LINK | 没有建链 | 是 | 上层排查Decode与Prompt建链情况。 |
| LLM\_ALREADY\_LINK | 已经建过链 | 是 | 上层排查Decode与Prompt建链情况。 |
| LLM\_LINK\_FAILED | 建链失败 | 是 | link\_clusters第二个返回值中有该错误码时，需要检查对应集群之间的网络连接。 |
| LLM\_UNLINK\_FAILED | 断链失败 | 是 | unlink\_clusters第二个返回值中有该错误码时，需要检查对应集群之间的网络连接。 |
| LLM\_NOTIFY\_PROMPT\_UNLINK\_FAILED | 通知Prompt侧断链失败 | 是 | 排查Decode与Prompt之间的网络连接。 主动调Prompt侧的unlink\_clusters清理残留资源。 |
| LLM\_CLUSTER\_NUM\_EXCEED\_LIMIT | 集群数量超过限制 | 是 | 排查link\_clusters和unlink\_clusters传入参数，clusters数量不能超过16。 |
| LLM\_PROCESSING\_LINK | 正在处理建链 | 是 | 当前正在执行建链或断链操作，请稍后再试。 |
| LLM\_PREFIX\_ALREADY\_EXIST | 前缀已经存在 | 是 | 检查是否已加载过相同Prefix Id的公共前缀。如果是，需要先释放。 |
| LLM\_PREFIX\_NOT\_EXIST | 前缀不存在 | 是 | 检查Request中的Prefix Id是否已加载过。 |
| LLM\_EXIST\_LINK | switch\_role时，存在未释放的链接 | 是 | 检查在切换当前LLMDataDist的角色前是否已经调用unlink\_clusters断开所有的链接。 |
| LLM\_FEATURE\_NOT\_ENABLED | 特性未使能 | 是 | 检查初始化LLMDataDist时是否传入了必要option: 如果是切换当前LLMDataDist的角色时抛出该异常，排查初始化时LLMConfig是否设置了enable\_switch\_role = True。 |
| LLM\_TIMEOUT | 处理超时 | 是 | 如果是pull\_cache、pull\_blocks、transfer\_cache\_async等传输相关接口报错，该链路不可恢复，需重新建链。 其他接口报该异常，加大超时时间并重试。 |
| LLM\_LINK\_BUSY | 链路繁忙 | 是 | 检查同时调用的接口是否有冲突，例如：同时调用如下接口时，会报该错误码。 同时调用unlink和 pull\_cache。 使用相同链路同时调用pull\_cache和transfer\_cache\_async。 |
| LLM\_OUT\_OF\_MEMORY | 内存不足 | 是 | 检查内存池是否足够容纳申请的KV大小； 检查申请的内存是否没有释放。 |
| LLM\_DEVICE\_MEM\_ERROR | 出现内存UCE（uncorrect error，指系统硬件不能直接处理恢复内存错误）的错误虚拟地址 | 是 | 请参考《Ascend Extension for PyTorch 自定义API参考(https://www.hiascend.com/document/detail/zh/Pytorch/2600/apiref/torchnpuCustomsapi/docs/zh/custom\_APIs/overview.md)》中的torch\_npu.npu.restart\_device接口的说明获取并修复内存UCE的错误虚拟地址。如果是KV Cache内存，需要再调用cache manager的remap\_registered\_memory接口修复注册给网卡的KV Cache内存。 说明：本错误码为预留，暂不支持。 |
| LLM\_SUSPECT\_REMOTE\_ERROR | 疑似是UCE内存故障 | 否 | 上层框架需要结合其它故障进行综合判断是UCE内存故障还是他故障。 |
| LLM\_UNKNOWN\_ERROR | 未知错误 | 否 | 保留现场，获取Host/Device日志，并备份。 |