CANN Runtime aclError 返回码全解:编码规则、错误码列表与实战定位指南

原创2026-09-19 18:58:302,621 阅读
文章标签:人工智能Ascend任务调度性能剖析

CANN Runtime aclError 返回码全解:编码规则、错误码列表与实战定位指南

本指南系统讲解 CANN Runtime 中 aclError 返回码的类型定义、编码规则、完整的返回码列表(通用 ACL 返回码、透传 RUNTIME 返回码、透传 GE 返回码),并结合开源仓库中的头文件定义、异常处理接口和可运行示例,介绍如何正确获取、解读与处理 ACL 接口返回的错误码,帮助开发者在昇腾 AI 处理器的应用开发中快速定位问题。

aclError 类型定义与代码位置

aclError 是 CANN 中所有 AscendCL(ACL)接口统一使用的错误码类型,其定义非常简单,本质上是 int 类型:

typedef int aclError;

该类型定义于 acl_base_rt.h,在仓库中的 include/external/acl/acl_base_rt.h 头文件内与其它基础类型(aclrtStream、aclrtContext、aclFloat16 等)一同声明。由于 ACL 接口均以 aclError 作为返回值,开发者在调用任意 ACL 接口后,都应检查其返回值以判断调用是否成功。

除了类型定义,该头文件还集中声明了 ACL 层自身的返回码常量,例如:

static const int ACL_SUCCESS = 0;                    // 执行成功
static const int ACL_ERROR_NONE = 0;                 // 执行成功(已废弃,见下文)
static const int ACL_ERROR_INVALID_EXCEPTION_INFO = -1; // 无效的异常信息
static const int ACL_ERROR_INVALID_PARAM = 100000;   // 参数校验失败
static const int ACL_ERROR_UNINITIALIZE = 100001;    // 未初始化

与之配套的,仓库在 include/external/acl/error_codes/rt_error_codes.h 中定义了透传 RUNTIME 模块的返回码(ACL_ERROR_RT_*),在 include/external/acl/error_codes/ge_error_codes.h 中定义了透传 GE(Graph Engine)模块的返回码(ACL_ERROR_GE_*)。这两类头文件与 acl_base_rt.h 共同构成了 CANN Runtime 对外暴露的完整返回码体系。

返回码编码规则

ACL 返回码并不是随意分配的数值,而是按照一套固定的编码规则进行划分。返回码由 6 位十进制数字构成,第一位数字(十万位)代表错误类别,通过最高位即可快速判断错误的性质:

  • 规则1(1XXXXX):开发人员的环境异常或者代码逻辑错误。此类问题可以通过优化环境或代码逻辑的方式解决,返回码定义为 1XXXXX。
  • 规则2(2XXXXX):资源不足(Stream、内存等)、开发人员编程时使用的接口或参数与当前硬件不匹配。可以通过在编程时合理使用资源的方式解决,返回码定义为 2XXXXX。
  • 规则3(3XXXXX):业务功能异常,比如队列满、队列空等,返回码定义为 3XXXXX。
  • 规则4(5XXXXX):软硬件内部异常,包括软件内部错误、Device 执行失败等。此类问题用户无法自行解决,需要将问题反馈给技术支持(建议在反馈前先获取相关日志),返回码定义为 5XXXXX。
  • 规则5:无法识别的错误,当前都映射为 500000,同样需要反馈给技术支持处理。

基于这一规则,1XXXXX 段集中了参数校验、初始化、模型加载、算子编译等开发阶段高频出现的错误;2XXXXX 段集中了内存分配、资源不足、队列满/空等资源类错误;3XXXXX 段目前仅有 ACL_ERROR_STORAGE_OVER_LIMIT = 300000(超出存储上限)等少量业务异常;5XXXXX 段则是软硬件内部错误的集合。

ACL 通用返回码列表

以下返回码直接由 ACL 层产生,定义于 acl_base_rt.h,含义、可能原因及解决方法如下表所示。

返回码 含义 可能原因及解决方法
static const int ACL_SUCCESS = 0; 执行成功。 -
static const int ACL_ERROR_INVALID_EXCEPTION_INFO = -1; 无效的异常信息。 请检查传入的异常信息参数值是否为空指针。
static const int ACL_ERROR_NONE = 0;
须知:ACL_ERROR_NONE返回码在CANN 8.5.0版本标记为废弃,将在2026年12月30日之后的版本删除,替换为:ACL_SUCCESS返回码。
执行成功。 -
static const int ACL_ERROR_INVALID_PARAM = 100000; 参数校验失败。 请检查接口的入参值是否正确。
static const int ACL_ERROR_UNINITIALIZE = 100001; 未初始化。 - 请检查是否已调用aclInit接口进行初始化,请确保已调用aclInit接口,且在其它acl接口之前调用。
- 请检查是否已调用对应功能的初始化接口,例如初始化Dump的aclmdlInitDump接口、初始化Profiling的aclprofInit接口。
static const int ACL_ERROR_REPEAT_INITIALIZE = 100002; 重复初始化或重复加载。 请检查是否调用对应的接口重复初始化或重复加载。
static const int ACL_ERROR_INVALID_FILE = 100003; 无效的文件。 请检查文件是否存在、文件是否能被访问等。
static const int ACL_ERROR_WRITE_FILE = 100004; 写文件失败。 请检查文件路径是否存在、文件是否有写权限等。
static const int ACL_ERROR_INVALID_FILE_SIZE = 100005; 无效的文件大小。 请检查文件大小是否符合接口要求。
static const int ACL_ERROR_PARSE_FILE = 100006; 解析文件失败。 请检查文件内容是否合法。
static const int ACL_ERROR_FILE_MISSING_ATTR = 100007; 文件缺失参数。 请检查文件内容是否完整。
static const int ACL_ERROR_FILE_ATTR_INVALID = 100008; 文件参数无效。 请检查文件中参数值是否正确。
static const int ACL_ERROR_INVALID_DUMP_CONFIG = 100009; 无效的Dump配置。 请检查Dump配置是否正确。
static const int ACL_ERROR_INVALID_PROFILING_CONFIG = 100010; 无效的Profiling配置。 请检查Profiling配置是否正确。
static const int ACL_ERROR_INVALID_MODEL_ID = 100011; 无效的模型ID。 请检查模型ID是否正确、模型是否正确加载。
static const int ACL_ERROR_DESERIALIZE_MODEL = 100012; 反序列化模型失败。 模型可能与当前版本不匹配,请重新构建模型。
static const int ACL_ERROR_PARSE_MODEL = 100013; 解析模型失败。 模型可能与当前版本不匹配,请重新构建模型。
static const int ACL_ERROR_READ_MODEL_FAILURE = 100014; 读取模型失败。 请检查模型文件是否存在、模型文件是否能被访问等。
static const int ACL_ERROR_MODEL_SIZE_INVALID = 100015; 无效的模型大小。 模型文件无效,请重新构建模型。
static const int ACL_ERROR_MODEL_MISSING_ATTR = 100016; 模型缺少参数。 模型可能与当前版本不匹配,请重新构建模型。
static const int ACL_ERROR_MODEL_INPUT_NOT_MATCH = 100017; 模型的输入不匹配。 请检查模型的输入是否正确。
static const int ACL_ERROR_MODEL_OUTPUT_NOT_MATCH = 100018; 模型的输出不匹配。 请检查模型的输出是否正确。
static const int ACL_ERROR_MODEL_NOT_DYNAMIC = 100019; 非动态模型。 请检查当前模型是否支持动态场景,如不支持,请重新构建模型。
static const int ACL_ERROR_OP_TYPE_NOT_MATCH = 100020; 单算子类型不匹配。 请检查算子类型是否正确。
static const int ACL_ERROR_OP_INPUT_NOT_MATCH = 100021; 单算子的输入不匹配。 请检查算子的输入是否正确。
static const int ACL_ERROR_OP_OUTPUT_NOT_MATCH = 100022; 单算子的输出不匹配。 请检查算子的输出是否正确。
static const int ACL_ERROR_OP_ATTR_NOT_MATCH = 100023; 单算子的属性不匹配。 请检查算子的属性是否正确。
static const int ACL_ERROR_OP_NOT_FOUND = 100024; 单算子未找到。 请检查算子类型是否支持。
static const int ACL_ERROR_OP_LOAD_FAILED = 100025; 单算子加载失败。 模型可能与当前版本不匹配,请重新构建单算子模型。
static const int ACL_ERROR_UNSUPPORTED_DATA_TYPE = 100026; 不支持的数据类型。 请检查数据类型是否存在或当前是否支持。
static const int ACL_ERROR_FORMAT_NOT_MATCH = 100027; Format不匹配。 请检查Format是否正确。
static const int ACL_ERROR_BIN_SELECTOR_NOT_REGISTERED = 100028; 使用二进制选择方式编译算子接口时,算子未注册选择器。 请检查是否调用aclopRegisterSelectKernelFunc接口注册算子选择器。
static const int ACL_ERROR_KERNEL_NOT_FOUND = 100029; 编译算子时,算子Kernel未注册。 请检查是否调用aclopCreateKernel接口注册算子Kernel。
static const int ACL_ERROR_BIN_SELECTOR_ALREADY_REGISTERED = 100030; 使用二进制选择方式编译算子接口时,算子重复注册。 请检查是否重复调用aclopRegisterSelectKernelFunc接口注册算子选择器。
static const int ACL_ERROR_KERNEL_ALREADY_REGISTERED = 100031; 编译算子时,算子Kernel重复注册。 请检查是否重复调用aclopCreateKernel接口注册算子Kernel。
static const int ACL_ERROR_INVALID_QUEUE_ID = 100032; 无效的队列ID。 请检查队列ID是否正确。
static const int ACL_ERROR_REPEAT_SUBSCRIBE = 100033; 重复订阅。 请检查针对同一个Stream,是否重复调用aclrtSubscribeReport接口。
static const int ACL_ERROR_STREAM_NOT_SUBSCRIBE = 100034;
须知:ACL_ERROR_STREAM_NOT_SUBSCRIBE返回码在CANN 8.5.0版本标记为废弃,将在2026年12月30日之后的版本删除,替换为:ACL_ERROR_RT_STREAM_NO_CB_REG返回码。
Stream未订阅。 请检查是否已调用aclrtSubscribeReport接口。
static const int ACL_ERROR_THREAD_NOT_SUBSCRIBE = 100035;
须知:ACL_ERROR_THREAD_NOT_SUBSCRIBE返回码在CANN 8.5.0版本标记为废弃,将在2026年12月30日之后的版本删除,替换为:ACL_ERROR_RT_THREAD_SUBSCRIBE返回码。
线程未订阅。 请检查是否已调用aclrtSubscribeReport接口。
static const int ACL_ERROR_WAIT_CALLBACK_TIMEOUT = 100036;
须知:ACL_ERROR_WAIT_CALLBACK_TIMEOUT返回码在CANN 8.5.0版本标记为废弃,将在2026年12月30日之后的版本删除,替换为:ACL_ERROR_RT_REPORT_TIMEOUT返回码。
等待callback超时。 请检查是否已调用aclrtLaunchCallback接口下发callback任务;
请检查aclrtProcessReport接口中超时时间是否合理;
请检查callback任务是否已经处理完成,如果已处理完成,但还调用aclrtProcessReport接口,则需优化代码逻辑。
static const int ACL_ERROR_REPEAT_FINALIZE = 100037; 重复去初始化。 请检查是否重复调用aclFinalize接口或重复调用aclFinalizeReference接口进行去初始化。
static const int ACL_ERROR_NOT_STATIC_AIPP = 100038;
须知:ACL_ERROR_NOT_STATIC_AIPP返回码在CANN 8.5.0版本标记为废弃,将在2026年12月30日之后的版本删除,替换为:ACL_ERROR_GE_AIPP_NOT_EXIST返回码。
静态AIPP配置信息不存在。 调用aclmdlGetFirstAippInfo接口时,请传入正确的index值。
static const int ACL_ERROR_COMPILING_STUB_MODE = 100039; 运行应用前配置的动态库路径是编译桩的路径,不是正确的动态库路径。 请检查动态库路径的配置,确保使用运行模式的动态库。
static const int ACL_ERROR_GROUP_NOT_SET = 100040;
须知:ACL_ERROR_GROUP_NOT_SET返回码在CANN 8.5.0版本标记为废弃,将在2026年12月30日之后的版本删除,替换为:ACL_ERROR_RT_GROUP_NOT_SET返回码。
未设置Group。 请检查是否已调用aclrtSetGroup接口。
static const int ACL_ERROR_GROUP_NOT_CREATE = 100041;
须知:ACL_ERROR_GROUP_NOT_CREATE返回码在CANN 8.5.0版本标记为废弃,将在2026年12月30日之后的版本删除,替换为:ACL_ERROR_RT_GROUP_NOT_CREATE返回码。
未创建对应的Group。 请检查调用接口时设置的Group ID是否在支持的范围内,Group ID的取值范围:[0, (Group数量-1)],用户可调用aclrtGetGroupCount接口获取Group数量。
static const int ACL_ERROR_PROF_ALREADY_RUN = 100042; 已存在采集Profiling数据的任务。 - 请检查代码逻辑,"通过调用AscendCL API方式采集Profiling数据"的配置不能与其它方式的Profiling配置并存,只能保留一种。
- 请检查是否对同一个Device重复下发了多次Profiling配置。
static const int ACL_ERROR_PROF_NOT_RUN = 100043; 未使用aclprofInit接口先进行Profiling初始化。 请检查接口调用顺序。
static const int ACL_ERROR_DUMP_ALREADY_RUN = 100044; 已存在获取Dump数据的任务。 请检查在调用aclmdlInitDump接口、aclmdlSetDump接口、aclmdlFinalizeDump接口配置Dump信息前,是否已调用aclInit接口配置Dump信息,如是,请调整代码逻辑,保留一种方式配置Dump信息即可。
static const int ACL_ERROR_DUMP_NOT_RUN = 100045; 未使用aclmdlInitDump接口先进行Dump初始化。 请检查获取Dump数据的接口调用顺序,参考aclmdlInitDump接口处的说明。
static const int ACL_ERROR_PROF_REPEAT_SUBSCRIBE = 148046; 重复订阅同一个模型。 请检查接口调用顺序。
static const int ACL_ERROR_PROF_API_CONFLICT = 148047; 采集性能数据的接口调用冲突。 两种方式的Profiling性能数据采集接口不能交叉调用,aclprofInit接口和aclprofFinalize接口之间不能调用aclprofModelSub接口、aclprofGet*接口、clprofModelUnSubscribe接口,aclprofModelSubscribe接口和aclprofModelUnSubscribe接口之间不能调用aclprofInit接口、aclprofStart接口、aclprofStop接口、aclprofFinalize。
static const int ACL_ERROR_INVALID_MAX_OPQUEUE_NUM_CONFIG = 148048; 无效的算子缓存信息老化配置。 请检查算子缓存信息老化配置,参考aclInit处的配置说明及示例。
static const int ACL_ERROR_INVALID_OPP_PATH = 148049; 没有设置ASCEND_OPP_PATH环境变量,或该环境变量的值设置错误。 请检查是否设置ASCEND_OPP_PATH环境变量,且该环境变量的值是否为opp软件包的安装路径。
static const int ACL_ERROR_OP_UNSUPPORTED_DYNAMIC = 148050; 算子不支持动态Shape。 - 请检查单算子模型文件中该算子的Shape是否为动态,如果是动态的,需要修改为固定Shape。
- 请检查编译算子时,aclTensorDesc的Shape是否为动态,如果是动态的,需要按照固定Shape重新创建aclTensorDesc。
static const int ACL_ERROR_RELATIVE_RESOURCE_NOT_CLEARED = 148051; 相关的资源尚未释放。 在销毁通道描述信息时,如果相关的通道尚未销毁则返回此错误码。请检查与此通道描述信息相关联的通道是否被销毁。
static const int ACL_ERROR_UNSUPPORTED_JPEG = 148052; JPEGD功能不支持的输入图片编码格式(例如算术编码、渐进式编码等)。 实现JPEGD图片解码功能时,仅支持Huffman编码,压缩前的原图像色彩空间为YUV,像素的各分量比例为4:4:4或4:2:2或4:2:0或4:0:0或4:4:0,不支持算术编码、不支持渐进JPEG格式、不支持JPEG2000格式。
static const int ACL_ERROR_INVALID_BUNDLE_MODEL_ID = 148053; 无效的模型ID。 请检查模型ID是否正确、模型是否正确加载。
static const int ACL_ERROR_BAD_ALLOC = 200000; 申请内存失败。 请检查硬件环境上的内存剩余情况。
static const int ACL_ERROR_API_NOT_SUPPORT = 200001; 接口不支持。 请检查调用的接口当前是否支持。
static const int ACL_ERROR_INVALID_DEVICE = 200002;
须知:ACL_ERROR_INVALID_DEVICE返回码在CANN 8.5.0版本标记为废弃,将在2026年12月30日之后的版本删除,替换为:ACL_ERROR_RT_INVALID_DEVICEID返回码。
无效的Device。 请检查Device是否存在。
static const int ACL_ERROR_MEMORY_ADDRESS_UNALIGNED = 200003; 内存地址未对齐。 请检查内存地址是否符合接口要求。
static const int ACL_ERROR_RESOURCE_NOT_MATCH = 200004; 资源不匹配。 请检查调用接口时,是否传入正确的Stream、Context等资源。
static const int ACL_ERROR_INVALID_RESOURCE_HANDLE = 200005; 无效的资源句柄。 请检查调用接口时,传入的Stream、Context等资源是否已被销毁或占用。
static const int ACL_ERROR_FEATURE_UNSUPPORTED = 200006; 特性不支持。 您可以获取日志后联系技术支持。
static const int ACL_ERROR_PROF_MODULES_UNSUPPORTED = 200007; 下发了不支持的Profiling配置。 请参见aclprofCreateConfig中的说明检查Profiling的配置是否正确。
static const int ACL_ERROR_STORAGE_OVER_LIMIT = 300000; 超出存储上限。 请检查硬件环境上的存储剩余情况。
static const int ACL_ERROR_INTERNAL_ERROR = 500000; 未知内部错误。 您可以获取日志后联系技术支持。
static const int ACL_ERROR_FAILURE = 500001; 内部错误。 您可以获取日志后联系技术支持。
static const int ACL_ERROR_GE_FAILURE = 500002; GE(Graph Engine)模块的错误。 您可以获取日志后联系技术支持。
static const int ACL_ERROR_RT_FAILURE = 500003; RUNTIME模块的错误。 您可以获取日志后联系技术支持。
static const int ACL_ERROR_DRV_FAILURE = 500004; Driver模块的错误。 您可以获取日志后联系技术支持。
static const int ACL_ERROR_PROFILING_FAILURE = 500005; Profiling模块的错误。 您可以获取日志后联系技术支持。

透传 RUNTIME 的返回码列表

当 RUNTIME(运行时管理模块)发生错误时,ACL 层会将其内部错误码透传给调用方。这类返回码以 ACL_ERROR_RT_ 为前缀,完整定义于 include/external/acl/error_codes/rt_error_codes.h,其中 ACL_RT_SUCCESS 定义于该文件第 20 行。下表为完整列表。

返回码 含义 可能原因及解决方法
#define ACL_RT_SUCCESS 0 执行成功。 -
#define ACL_ERROR_RT_PARAM_INVALID 107000 参数校验失败。 请检查接口入参是否正确。
#define ACL_ERROR_RT_INVALID_DEVICEID 107001 无效的Device ID。 请检查Device ID是否合法。
#define ACL_ERROR_RT_CONTEXT_NULL 107002 context为空。 请检查是否调用aclrtSetCurrentContext或aclrtSetDevice。
#define ACL_ERROR_RT_STREAM_CONTEXT 107003 stream不在当前context内。 请检查stream所在的context与当前context是否一致。
#define ACL_ERROR_RT_MODEL_CONTEXT 107004 model不在当前context内。 请检查加载的模型与当前context是否一致。
#define ACL_ERROR_RT_STREAM_MODEL 107005 stream不在当前model内。 请检查stream是否绑定过该模型。
#define ACL_ERROR_RT_EVENT_TIMESTAMP_INVALID 107006 event时间戳无效。 请检查event是否创建。
#define ACL_ERROR_RT_EVENT_TIMESTAMP_REVERSAL 107007 event时间戳反转。 请检查event是否创建。
#define ACL_ERROR_RT_ADDR_UNALIGNED 107008 内存地址未对齐。 请检查所申请的内存地址是否对齐。
#define ACL_ERROR_RT_FILE_OPEN 107009 打开文件失败。 请检查文件是否存在。
#define ACL_ERROR_RT_FILE_WRITE 107010 写文件失败。 请检查文件是否存在或者是否具备写权限。
#define ACL_ERROR_RT_STREAM_SUBSCRIBE 107011 stream未订阅或重复订阅。 请检查当前stream是否订阅或重复订阅。
#define ACL_ERROR_RT_THREAD_SUBSCRIBE 107012 线程未订阅或重复订阅。 请检查当前线程是否订阅或重复订阅。
#define ACL_ERROR_RT_GROUP_NOT_SET 107013 未设置Group。 请检查是否已调用aclrtSetGroup接口。
#define ACL_ERROR_RT_GROUP_NOT_CREATE 107014 未创建对应的Group。 请检查调用接口时设置的Group ID是否在支持的范围内,Group ID的取值范围:[0, (Group数量-1)],用户可调用aclrtGetGroupCount接口获取Group数量。
#define ACL_ERROR_RT_STREAM_NO_CB_REG 107015 该callback对应的stream未注册到线程。 请检查stream是否已经注册到线程,检查是否调用aclrtSubscribeReport接口。
#define ACL_ERROR_RT_INVALID_MEMORY_TYPE 107016 无效的内存类型。 请检查内存类型是否合法。
#define ACL_ERROR_RT_INVALID_HANDLE 107017 无效的资源句柄。 检查对应输入和使用的参数是否正确。
#define ACL_ERROR_RT_INVALID_MALLOC_TYPE 107018 申请使用的内存类型不正确。 检查对应输入和使用的内存类型是否正确。
#define ACL_ERROR_RT_WAIT_TIMEOUT 107019 等待超时。 请尝试重新执行下发任务的接口。
#define ACL_ERROR_RT_TASK_TIMEOUT 107020 执行任务超时。 请排查业务编排是否合理或者设置合理的超时时间。
#define ACL_ERROR_RT_SYSPARAMOPT_NOT_SET 107021 获取当前Context中的系统参数值失败。 未设置当前Context中的系统参数值,请参见aclrtCtxSetSysParamOpt。
#define ACL_ERROR_RT_DEVICE_TASK_ABORT 107022 Device上的任务丢弃操作与其它操作冲突。 该错误码是由于调用aclrtDeviceTaskAbort接口停止Device上的任务与其它接口操作冲突,用户需排查代码逻辑,等待aclrtDeviceTaskAbort接口执行完成后,才执行其它操作。
#define ACL_ERROR_RT_STREAM_ABORT 107023 正在清除Stream上的任务。 正在清除指定Stream上的任务,不支持同步等待该Stream上的任务执行。
#define ACL_ERROR_RT_CAPTURE_DEPENDENCY 107024 基于捕获方式构建模型运行实例时,event wait任务没有对应的event record任务。 调用aclrtRecordEvent接口增加event record任务。
#define ACL_ERROR_RT_STREAM_UNJOINED 107025 跨流捕获场景下,子流的最后一个任务不是event record任务,或者子流的最后一个event record任务没有对应的event wait任务,或者子流没有返回到主流。 - 子流的最后一个任务不是event record任务。在报错的子流最后下发一个event record任务(调用aclrtRecordEvent接口)。
- 子流的最后一个event record任务没有对应的event wait任务。在非报错的Stream上下发一个event wait任务(调用aclrtStreamWaitEvent接口)。
- 子流没有返回到主流。通过合理下发event record和event wait任务,使子流返回到主流。
#define ACL_ERROR_RT_MODEL_CAPTURED 107026 模型已经处于捕获状态。 先调用aclmdlRICaptureEnd接口结束捕获,再执行对应的操作。
#define ACL_ERROR_RT_STREAM_CAPTURED 107027 Stream已经处于捕获状态。 先调用aclmdlRICaptureEnd接口结束捕获,再执行对应的操作。
#define ACL_ERROR_RT_EVENT_CAPTURED 107028 Event已经处于捕获状态。 先调用aclmdlRICaptureEnd接口结束捕获,再执行对应的操作。
#define ACL_ERROR_RT_STREAM_NOT_CAPTURED 107029 Stream不在捕获状态。 请检查是否已调用aclmdlRICaptureBegin开始捕获Stream上下发的任务。
#define ACL_ERROR_RT_CAPTURE_MODE_NOT_SUPPORT 107030 当前的捕获模式不支持该操作。 不同捕获模式支持的操作范围不同,请参见aclmdlRICaptureThreadExchangeMode接口中的说明,并切换到正确的捕获模式。
#define ACL_ERROR_RT_STREAM_CAPTURE_IMPLICIT 107031 捕获场景下不允许使用默认Stream。 请尝试使用其他Stream替代默认Stream。
#define ACL_ERROR_STREAM_CAPTURE_CONFLICT 107032 Event与Stream所在的模型运行实例不一致。 请检查同时在调用aclmdlRICaptureBegin操作的多个Stream是否通过Event建立关联关系。
#define ACL_ERROR_STREAM_TASK_GROUP_STATUS 107033 任务组状态异常。 造成该错误的原因可能如下,请排查。

- 调用aclmdlRICaptureTaskGrpBegin对同一Stream重复开启任务组记录;
- 调用aclmdlRICaptureTaskUpdateBegin对同一任务组同时进行更新;
- aclmdlRICaptureTaskGrpBegin未与aclmdlRICaptureTaskGrpEnd配对使用;
- aclmdlRICaptureTaskUpdateBegin未与aclmdlRICaptureTaskUpdateEnd配对使用;
- 使用同一Stream同时进行记录和更新任务组操作。
#define ACL_ERROR_STREAM_TASK_GROUP_INTR 107034 任务组记录过程中断。 该错误的原因是记录任务组时将任务提交到了未开启任务组记录的捕获流上。
建议先aclmdlRICaptureTaskUpdateBegin接口开启了任务组记录,再提交任务。
#define ACL_ERROR_RT_STREAM_CAPTURE_UNMATCHED 107036 捕获过程中发现不匹配的操作,没有调用aclmdlRICaptureBegin接口开始捕获Stream上的任务。 请检查代码逻辑,先调用aclmdlRICaptureBegin接口开始捕获Stream上的任务,再调用aclmdlRICaptureEnd接口结束捕获。
#define ACL_ERROR_RT_MODEL_RUNNING 107037 当前模型正在执行,不能销毁。 请检查代码逻辑,在模型执行完成后,再销毁模型。
#define ACL_ERROR_RT_STREAM_CAPTURE_WRONG_THREAD 107038 aclmdlRICaptureEnd与aclmdlRICaptureBegin不在同一个线程中。 在aclmdlRICaptureBegin接口中,如果将mode设置为非ACL_MODEL_RI_CAPTURE_MODE_RELAXED的值,则aclmdlRICaptureEnd接口和aclmdlRICaptureBegin接口必须位于同一线程中。
#define ACL_ERROR_RT_INSUFFICIENT_INPUT_ARRAY 107039 数组空间不足,数组大小小于实际所需数组大小。 调整输入的数组大小。
#define ACL_ERROR_RT_MODEL_UPDATE_FAILED 107040 模型未完全捕获、模型正在执行中,或参数更新失败导致模型更新失败。 确保模型已成功捕获、执行完成或参数更新成功。
#define ACL_ERROR_RT_CAPTURE_MODE_BLOCK_ASYNC 107041 当前的捕获模式不支持异步转同步操作。 不同捕获模式支持的操作范围不同,请参见aclmdlRICaptureThreadExchangeMode接口中的说明,并切换到正确的捕获模式。
#define ACL_ERROR_RT_SYMBOL_NOT_FOUND 107042 符号未找到。 请检查全局变量名称是否与算子二进制中的全局变量名称一致。
#define ACL_ERROR_RT_INVALID_SYMBOL 107043 无效的符号。 请检查变量名是否在Device代码中声明。
#define ACL_ERROR_RT_INVALID_DEVICE_FUNCTION 107044 无效的核函数符号。 请检查核函数是否在Device代码中声明。
#define ACL_ERROR_RT_FEATURE_NOT_SUPPORT 207000 特性不支持。 您可以获取日志后联系技术支持。
#define ACL_ERROR_RT_MEMORY_ALLOCATION 207001 内存申请失败。 请检查硬件环境上的存储剩余情况。
#define ACL_ERROR_RT_MEMORY_FREE 207002 内存释放失败。 您可以获取日志后联系技术支持。
#define ACL_ERROR_RT_AICORE_OVER_FLOW 207003 AI Core算子运算溢出。 请检查对应的AI Core算子运算是否有溢出,可以根据dump数据找到对应溢出的算子,再定位具体的算子问题。
#define ACL_ERROR_RT_NO_DEVICE 207004 Device不可用。 请检查Device是否正常运行。
#define ACL_ERROR_RT_RESOURCE_ALLOC_FAIL 207005 资源申请失败。 请检查Stream等资源的使用情况,及时释放不用的资源。
#define ACL_ERROR_RT_NO_PERMISSION 207006 没有操作权限。 请检查运行应用的用户权限是否正确。
#define ACL_ERROR_RT_NO_EVENT_RESOURCE 207007 Event资源不足。 请参考aclrtCreateEvent接口处的说明检查Event数量是否符合要求。
#define ACL_ERROR_RT_NO_STREAM_RESOURCE 207008 Stream资源不足。 请参考aclrtCreateStream接口处的说明检查Stream数量是否符合要求。
#define ACL_ERROR_RT_NO_NOTIFY_RESOURCE 207009 系统内部Notify资源不足。 媒体数据处理的并发任务太多或模型推理时消耗资源太多,建议尝试减少并发任务或卸载部分模型。
#define ACL_ERROR_RT_NO_MODEL_RESOURCE 207010 模型资源不足。 建议卸载部分模型。
#define ACL_ERROR_RT_NO_CDQ_RESOURCE 207011 Runtime内部资源不足。 您可以获取日志后联系技术支持。
#define ACL_ERROR_RT_OVER_LIMIT 207012 队列数目超出上限。 请销毁不需要的队列之后再创建新的队列。
#define ACL_ERROR_RT_QUEUE_EMPTY 207013 队列为空。 不能从空队列中获取数据,请先向队列中添加数据,再获取。
#define ACL_ERROR_RT_QUEUE_FULL 207014 队列已满。 不能向已满的队列中添加数据,请先从队列中获取数据,再添加。
#define ACL_ERROR_RT_REPEATED_INIT 207015 队列重复初始化。 建议初始化一次队列即可,不要重复初始化。
#define ACL_ERROR_RT_DEVICE_OOM 207018 Device侧内存耗尽。 排查Device上的内存使用情况,并根据Device上的内存规格合理规划内存的使用。
#define ACL_ERROR_RT_FEATURE_NOT_SUPPORT_UPDATE_OP 207019 当前驱动版本不支持更新该算子。 请检查驱动版本,在"固件与驱动"页面下载 Ascend HDK 25.0.RC1 或更高版本的驱动安装包,并参考相应版本的文档进行安装、升级。
#define ACL_ERROR_RT_TIMEOUT 207020 Driver执行超时。 您可以获取日志后联系技术支持。
#define ACL_ERROR_RT_LINK_TYPE_NOT_SUPPORTED 207021 指定的连接类型不支持。 排查使用的连接类型硬件是否支持。
#define ACL_ERROR_RT_INTERNAL_ERROR 507000 runtime模块内部错误。 您可以获取日志后联系技术支持。
#define ACL_ERROR_RT_TS_ERROR 507001 Device上的task scheduler模块内部错误。 您可以获取日志后联系技术支持。
#define ACL_ERROR_RT_STREAM_TASK_FULL 507002 stream上的task数量满。 您可以获取日志后联系技术支持。
#define ACL_ERROR_RT_STREAM_TASK_EMPTY 507003 stream上的task数量为空。 您可以获取日志后联系技术支持。
#define ACL_ERROR_RT_STREAM_NOT_COMPLETE 507004 stream上的task未全部执行完成。 您可以获取日志后联系技术支持。
#define ACL_ERROR_RT_END_OF_SEQUENCE 507005 AI CPU上的task执行完成。 您可以获取日志后联系技术支持。
#define ACL_ERROR_RT_EVENT_NOT_COMPLETE 507006 event未完成。 您可以获取日志后联系技术支持。
#define ACL_ERROR_RT_CONTEXT_RELEASE_ERROR 507007 context释放失败。 您可以获取日志后联系技术支持。
#define ACL_ERROR_RT_SOC_VERSION 507008 获取soc version失败。 您可以获取日志后联系技术支持。
#define ACL_ERROR_RT_TASK_TYPE_NOT_SUPPORT 507009 不支持的task类型。 您可以获取日志后联系技术支持。
#define ACL_ERROR_RT_LOST_HEARTBEAT 507010 task scheduler丢失心跳。 您可以获取日志后联系技术支持。
#define ACL_ERROR_RT_MODEL_EXECUTE 507011 模型执行失败。 您可以获取日志后联系技术支持。
#define ACL_ERROR_RT_REPORT_TIMEOUT 507012 获取task scheduler的消息失败。 排查接口的超时时间设置是否过短,适当增长超时时间。如果增长超时时间后,依然有超时报错,再排查日志。
您可以获取日志后联系技术支持。
#define ACL_ERROR_RT_SYS_DMA 507013 system dma(Direct Memory Access)硬件执行错误。 您可以获取日志后联系技术支持。
#define ACL_ERROR_RT_AICORE_TIMEOUT 507014 AI Core执行超时。 您可以获取日志后联系技术支持。
日志的详细介绍,请参见《日志参考》。
#define ACL_ERROR_RT_AICORE_EXCEPTION 507015 AI Core执行异常。 您可以获取日志后联系技术支持。
#define ACL_ERROR_RT_AICORE_TRAP_EXCEPTION 507016 AI Core trap执行异常。 您可以获取日志后联系技术支持。
#define ACL_ERROR_RT_AICPU_TIMEOUT 507017 AI CPU执行超时。 您可以获取日志后联系技术支持。
#define ACL_ERROR_RT_AICPU_EXCEPTION 507018 AI CPU执行异常。 您可以获取日志后联系技术支持。
#define ACL_ERROR_RT_AICPU_DATADUMP_RSP_ERR 507019 AI CPU执行数据dump后未给task scheduler返回响应。 您可以获取日志后联系技术支持。
#define ACL_ERROR_RT_AICPU_MODEL_RSP_ERR 507020 AI CPU执行模型后未给task scheduler返回响应。 您可以获取日志后联系技术支持。
#define ACL_ERROR_RT_PROFILING_ERROR 507021 profiling功能执行异常。 您可以获取日志后联系技术支持。
#define ACL_ERROR_RT_IPC_ERROR 507022 进程间通信异常。 您可以获取日志后联系技术支持。
#define ACL_ERROR_RT_MODEL_ABORT_NORMAL 507023 模型退出。 您可以获取日志后联系技术支持。
#define ACL_ERROR_RT_KERNEL_UNREGISTERING 507024 算子正在去注册。 您可以获取日志后联系技术支持。
#define ACL_ERROR_RT_RINGBUFFER_NOT_INIT 507025 ringbuffer(环形缓冲区)功能未初始化。 您可以获取日志后联系技术支持。
#define ACL_ERROR_RT_RINGBUFFER_NO_DATA 507026 ringbuffer(环形缓冲区)没有数据。 您可以获取日志后联系技术支持。
#define ACL_ERROR_RT_KERNEL_LOOKUP 507027 RUNTIME内部的kernel未注册。 您可以获取日志后联系技术支持。
#define ACL_ERROR_RT_KERNEL_DUPLICATE 507028 重复注册RUNTIME内部的kernel。 您可以获取日志后联系技术支持。
#define ACL_ERROR_RT_DEBUG_REGISTER_FAIL 507029 debug功能注册失败。 您可以获取日志后联系技术支持。
#define ACL_ERROR_RT_DEBUG_UNREGISTER_FAIL 507030 debug功能去注册失败。 您可以获取日志后联系技术支持。
#define ACL_ERROR_RT_LABEL_CONTEXT 507031 标签不在当前context内。 您可以获取日志后联系技术支持。
#define ACL_ERROR_RT_PROGRAM_USE_OUT 507032 注册的program数量超过限制。 您可以获取日志后联系技术支持。
#define ACL_ERROR_RT_DEV_SETUP_ERROR 507033 Device启动失败。 您可以获取日志后联系技术支持。
#define ACL_ERROR_RT_VECTOR_CORE_TIMEOUT 507034 vector core执行超时。 您可以获取日志后联系技术支持。
#define ACL_ERROR_RT_VECTOR_CORE_EXCEPTION 507035 vector core执行异常。 您可以获取日志后联系技术支持。
#define ACL_ERROR_RT_VECTOR_CORE_TRAP_EXCEPTION 507036 vector core trap执行异常。 您可以获取日志后联系技术支持。
#define ACL_ERROR_RT_CDQ_BATCH_ABNORMAL 507037 Runtime内部资源申请异常。 您可以获取日志后联系技术支持。
#define ACL_ERROR_RT_DIE_MODE_CHANGE_ERROR 507038 die模式修改异常,不能修改die模式。 您可以获取日志后联系技术支持。
#define ACL_ERROR_RT_DIE_SET_ERROR 507039 单die模式不能指定die。 您可以获取日志后联系技术支持。
#define ACL_ERROR_RT_INVALID_DIEID 507040 指定die id错误。 您可以获取日志后联系技术支持。
#define ACL_ERROR_RT_DIE_MODE_NOT_SET 507041 die模式没有设置。 您可以获取日志后联系技术支持。
#define ACL_ERROR_RT_AICORE_TRAP_READ_OVERFLOW 507042 AI Core trap读越界异常。 您可以获取日志后联系技术支持。
#define ACL_ERROR_RT_AICORE_TRAP_WRITE_OVERFLOW 507043 AI Core trap写越界异常。 您可以获取日志后联系技术支持。
#define ACL_ERROR_RT_VECTOR_CORE_TRAP_READ_OVERFLOW 507044 Vector Core trap读越界异常。 您可以获取日志后联系技术支持。
#define ACL_ERROR_RT_VECTOR_CORE_TRAP_WRITE_OVERFLOW 507045 Vector Core trap写越界异常。 您可以获取日志后联系技术支持。
#define ACL_ERROR_RT_STREAM_SYNC_TIMEOUT 507046 在指定的超时等待事件中,指定的stream中所有任务还没有执行完成。 您可以获取日志后联系技术支持。
#define ACL_ERROR_RT_EVENT_SYNC_TIMEOUT 507047 在指定的Event同步等待中,超过指定时间,该Event还没有执行完。 您可以获取日志后联系技术支持。
#define ACL_ERROR_RT_FFTS_PLUS_TIMEOUT 507048 内部任务执行超时。 您可以获取日志后联系技术支持。
#define ACL_ERROR_RT_FFTS_PLUS_EXCEPTION 507049 内部任务执行异常。 您可以获取日志后联系技术支持。
#define ACL_ERROR_RT_FFTS_PLUS_TRAP_EXCEPTION 507050 内部任务trap异常。 您可以获取日志后联系技术支持。
#define ACL_ERROR_RT_SEND_MSG 507051 数据入队过程中消息发送失败。 您可以获取日志后联系技术支持。
#define ACL_ERROR_RT_COPY_DATA 507052 数据入队过程中内存拷贝失败。 您可以获取日志后联系技术支持。
#define ACL_ERROR_RT_DEVICE_MEM_ERROR 507053 出现内存UCE(uncorrectable error,指系统硬件不能直接处理恢复内存错误)的错误虚拟地址。 请参见aclrtGetMemUceInfo接口中的说明获取并修复内存UCE的错误虚拟地址。
#define ACL_ERROR_RT_HBM_MULTI_BIT_ECC_ERROR 507054 HBM比特ECC故障。 您可以获取日志后联系技术支持。
#define ACL_ERROR_RT_SUSPECT_DEVICE_MEM_ERROR 507055 多进程、多Device场景下,可能出现内存UCE错误。 由于当前Device访问的对端Device内存发生故障,用户需排查对端Device进程的错误信息。
#define ACL_ERROR_RT_LINK_ERROR 507056 多Device场景下,两个Device之间的通信断链。 建议重试,若依然报错,则需检查两个Device之间的通信链路。
#define ACL_ERROR_RT_SUSPECT_REMOTE_ERROR 507057 多进程、多Device场景下,对端Device内存可能出现故障,或者当前Device内存访问越界。 用户需排查对端Device进程的错误信息或当前Device的内存访问情况。
#define ACL_ERROR_RT_DRV_INTERNAL_ERROR 507899 Driver模块内部错误。 您可以获取日志后联系技术支持。
#define ACL_ERROR_RT_AICPU_INTERNAL_ERROR 507900 AI CPU模块内部错误。 您可以获取日志后联系技术支持。
#define ACL_ERROR_RT_SOCKET_CLOSE 507901 内部HDC(Host Device Communication)会话连接断开。 您可以获取日志后联系技术支持。
#define ACL_ERROR_RT_AICPU_INFO_LOAD_RSP_ERR 507902 AI CPU调度处理失败。 您可以获取日志后联系技术支持。
#define ACL_ERROR_RT_STREAM_CAPTURE_INVALIDATED 507903 模型捕获异常。 您可以获取日志后联系技术支持。
#define ACL_ERROR_RT_COMM_OP_RETRY_FAIL 507904 通信算子重执行失败。 您可以获取日志后联系技术支持。
#define ACL_ERROR_SNAPSHOT_LOCK_TIMEOUT 507905 调用aclrtSnapShotProcessLock接口超时。 您可以获取日志后联系技术支持。
#define ACL_ERROR_SNAPSHOT_LOCK_FAILED 507906 锁定当前进程失败。 您可以获取日志后联系技术支持。
#define ACL_ERROR_SNAPSHOT_UNLOCK_FAILED 507907 解锁当前进程失败。 您可以获取日志后联系技术支持。
#define ACL_ERROR_SNAPSHOT_BACKUP_FAILED 507908 备份快照进程失败。 您可以获取日志后联系技术支持。
#define ACL_ERROR_SNAPSHOT_RESTORE_FAILED 507909 恢复快照进程失败。 您可以获取日志后联系技术支持。
#define ACL_ERROR_HOST_MEMORY_ALREADY_REGISTERED 507910 Host内存已经被注册。 您可以获取日志后联系技术支持。
#define ACL_ERROR_HOST_MEMORY_NOT_REGISTERED 507911 待取消注册的Host内存未曾注册。 您可以获取日志后联系技术支持。
#define ACL_ERROR_SNAPSHOT_CALLBACK_FAILED 507912 快照某个阶段,执行回调函数失败。 您可以获取日志后联系技术支持。
#define ACL_ERROR_SNAPSHOT_REGISTER_CALLBACK_FAILED 507913 注册回调函数失败。 您可以获取日志后联系技术支持。
#define ACL_ERROR_RT_L3_PORT_ERROR 507914 L3端口错误。 您可以获取日志后联系技术支持。
#define ACL_ERROR_RT_CCU_TIMEOUT 507915 CCU执行超时。 您可以获取日志后联系技术支持。
#define ACL_ERROR_RT_CCU_EXCEPTION 507916 CCU执行异常。 您可以获取日志后联系技术支持。

从源码定义可以看出,RUNTIME 透传错误码同样遵循统一的编码规则:107xxx 对应参数与资源句柄类错误,207xxx 对应资源不足与队列类错误,507xxx 对应运行时内部异常(AI Core/AI CPU 超时与异常、UCE、断链等)。特别值得注意的是 507053(内存 UCE)与 507054(HBM 多比特 ECC 故障)属于硬件层面的严重错误,出现时应优先按 13 异常处理 章节中的 aclrtGetMemUceInfo/aclrtMemUceRepair 接口说明处理。

透传 GE 的返回码列表

当错误由 GE(Graph Engine,图引擎)模块产生时,ACL 层会透传 GE 的返回码。这类返回码以 ACL_ERROR_GE_ 为前缀、以 uint32_t 类型定义,完整定义于 include/external/acl/error_codes/ge_error_codes.h,例如 ACL_ERROR_GE_PARAM_INVALID = 145000U 位于该文件第 34 行。下表为完整列表。

返回码 含义 可能原因及解决方法
uint32_t ACL_ERROR_GE_PARAM_INVALID = 145000; 参数校验失败。 请检查接口的入参值是否正确。
uint32_t ACL_ERROR_GE_EXEC_NOT_INIT = 145001; 未初始化。 - 请检查是否已调用aclInit接口进行初始化,请确保已调用aclInit接口,且在其它acl接口之前调用。
- 请检查是否已调用对应功能的初始化接口,例如初始化Dump的aclmdlInitDump接口、初始化Profiling的aclprofInit接口。
uint32_t ACL_ERROR_GE_EXEC_MODEL_PATH_INVALID = 145002; 无效的模型路径。 请检查模型路径是否正确。
uint32_t ACL_ERROR_GE_EXEC_MODEL_ID_INVALID = 145003; 无效的模型ID。 请检查模型ID是否正确、模型是否正确加载。
uint32_t ACL_ERROR_GE_EXEC_MODEL_DATA_SIZE_INVALID = 145006; 无效的模型大小。 模型文件无效,请重新构建模型。
uint32_t ACL_ERROR_GE_EXEC_MODEL_ADDR_INVALID = 145007; 无效的模型内存地址。 请检查模型地址是否有效。
uint32_t ACL_ERROR_GE_EXEC_MODEL_QUEUE_ID_INVALID = 145008; 无效的队列ID。 请检查队列ID是否正确。
uint32_t ACL_ERROR_GE_EXEC_LOAD_MODEL_REPEATED = 145009; 重复初始化或重复加载。 请检查是否调用对应的接口重复初始化或重复加载。
uint32_t ACL_ERROR_GE_DYNAMIC_INPUT_ADDR_INVALID = 145011; 无效的动态分档输入地址。 请检查动态分档输入地址。
uint32_t ACL_ERROR_GE_DYNAMIC_INPUT_LENGTH_INVALID = 145012; 无效的动态分档输入长度。 请检查动态分档输入长度。
uint32_t ACL_ERROR_GE_DYNAMIC_BATCH_SIZE_INVALID = 145013; 无效的动态分档Batch大小。 请检查动态分档Batch大小。
uint32_t ACL_ERROR_GE_AIPP_BATCH_EMPTY = 145014; 无效的AIPP batch size。 请检查AIPP batch size是否正确。
uint32_t ACL_ERROR_GE_AIPP_NOT_EXIST = 145015; AIPP配置不存在。 请检查AIPP是否配置。
uint32_t ACL_ERROR_GE_AIPP_MODE_INVALID = 145016; 无效的AIPP模式。 请检查模型转换时配置的AIPP模式是否正确。
uint32_t ACL_ERROR_GE_OP_TASK_TYPE_INVALID = 145017; 无效的任务类型。 请检查算子类型是否正确。
uint32_t ACL_ERROR_GE_OP_KERNEL_TYPE_INVALID = 145018; 无效的算子类型。 请检查算子类型是否正确。
uint32_t ACL_ERROR_GE_PLGMGR_PATH_INVALID = 145019; 无效的so文件,包括so文件的路径层级太深、so文件被误删除等情况。 请检查运行应用前配置的环境变量LD_LIBRARY_PATH是否正确。
uint32_t ACL_ERROR_GE_FORMAT_INVALID = 145020; 无效的format。 请检查Tensor数据的format是否有效。
uint32_t ACL_ERROR_GE_SHAPE_INVALID = 145021; 无效的shape。 请检查Tensor数据的shape是否有效。
uint32_t ACL_ERROR_GE_DATATYPE_INVALID = 145022; 无效的数据类型。 请检查Tensor数据的数据类型是否有效。
uint32_t ACL_ERROR_GE_MEMORY_ALLOCATION = 245000; 申请内存失败。 请检查硬件环境上的内存剩余情况。
uint32_t ACL_ERROR_GE_MEMORY_OPERATE_FAILED = 245001; 内存初始化、内存复制操作失败。 请检查内存地址是否正确、硬件环境上的内存是否足够等。
uint32_t ACL_ERROR_GE_DEVICE_MEMORY_ALLOCATION_FAILED = 245002; 申请Device内存失败。 Device内存已用完,无法继续申请,请释放部分Device内存,再重新尝试。
uint32_t ACL_ERROR_GE_SUBHEALTHY = 345102; 亚健康状态。 设备或进程异常触发的重部署动作完成后的状态为亚健康状态,亚健康状态下可以正常调用相关接口。
static const uint32_t ACL_ERROR_GE_USER_RAISE_EXCEPTION = 345103; 用户自定义函数主动抛异常。 用户可根据DataFlowInfo中设置的UserData识别出来哪个输入的数据执行报错了,再根据报错排查问题。
static const uint32_t ACL_ERROR_GE_DATA_NOT_ALIGNED = 345104; 数据未对齐。 若用户自定义函数存在多个输出时,需排查用户代码中是否少设置输出,缺少输出可能会导致数据对齐异常。
uint32_t ACL_ERROR_GE_INTERNAL_ERROR = 545000; 未知内部错误。 您可以获取日志后联系技术支持。
uint32_t ACL_ERROR_GE_LOAD_MODEL = 545001; 系统内部加载模型失败。 您可以获取日志后联系技术支持。
uint32_t ACL_ERROR_GE_EXEC_LOAD_MODEL_PARTITION_FAILED = 545002; 系统内部加载模型失败。 您可以获取日志后联系技术支持。
uint32_t ACL_ERROR_GE_EXEC_LOAD_WEIGHT_PARTITION_FAILED = 545003; 系统内部加载模型权值失败。 您可以获取日志后联系技术支持。
uint32_t ACL_ERROR_GE_EXEC_LOAD_TASK_PARTITION_FAILED = 545004; 系统内部加载模型任务失败。 您可以获取日志后联系技术支持。
uint32_t ACL_ERROR_GE_EXEC_LOAD_KERNEL_PARTITION_FAILED = 545005; 系统内部加载模型算子失败。 您可以获取日志后联系技术支持。
uint32_t ACL_ERROR_GE_EXEC_RELEASE_MODEL_DATA = 545006; 系统内释放模型空间失败。 您可以获取日志后联系技术支持。
uint32_t ACL_ERROR_GE_COMMAND_HANDLE = 545007; 系统内命令操作失败。 您可以获取日志后联系技术支持。
uint32_t ACL_ERROR_GE_GET_TENSOR_INFO = 545008; 系统内获取张量数据失败。 您可以获取日志后联系技术支持。
uint32_t ACL_ERROR_GE_UNLOAD_MODEL = 545009; 系统内卸载模型空间失败。 您可以获取日志后联系技术支持。
uint32_t ACL_ERROR_GE_MODEL_EXECUTE_TIMEOUT = 545601; 模型执行超时。 您可以获取日志后联系技术支持。
uint32_t ACL_ERROR_GE_REDEPLOYING = 545602; 正在重部署。 等待重部署动作完成后重新调用相关接口。

GE 透传错误码的编码风格与 ACL 通用错误码一致:145xxx 为参数与模型/算子校验类错误,245xxx 为内存类错误,345xxx 为业务状态类错误(如亚健康状态、用户函数主动抛异常),545xxx 为内部执行错误。其中 ACL_ERROR_GE_PLGMGR_PATH_INVALID(145019)在实际开发中较为常见,通常与 LD_LIBRARY_PATH 环境变量配置不当、so 文件被误删除有关。

废弃返回码与迁移建议

根据仓库 acl_base_rt.h 中的 @deprecated 注释,以下返回码自 CANN 8.5.0 版本标记为废弃,将在 2026年12月30日之后的版本删除,迁移替换关系如下:

废弃返回码 替换返回码
ACL_ERROR_NONE(0) ACL_SUCCESS(0)
ACL_ERROR_STREAM_NOT_SUBSCRIBE(100034) ACL_ERROR_RT_STREAM_NO_CB_REG(107015)
ACL_ERROR_THREAD_NOT_SUBSCRIBE(100035) ACL_ERROR_RT_THREAD_SUBSCRIBE(107012)
ACL_ERROR_WAIT_CALLBACK_TIMEOUT(100036) ACL_ERROR_RT_REPORT_TIMEOUT(507012)
ACL_ERROR_NOT_STATIC_AIPP(100038) ACL_ERROR_GE_AIPP_NOT_EXIST(145015)
ACL_ERROR_GROUP_NOT_SET(100040) ACL_ERROR_RT_GROUP_NOT_SET(107013)
ACL_ERROR_GROUP_NOT_CREATE(100041) ACL_ERROR_RT_GROUP_NOT_CREATE(107014)
ACL_ERROR_INVALID_DEVICE(200002) ACL_ERROR_RT_INVALID_DEVICEID(107001)

在使用新版本 CANN 进行开发时,建议直接在代码中采用替换后的新返回码,避免因返回码常量被删除导致编译失败;同时,判断成功时应统一使用 ACL_SUCCESS 而非 ACL_ERROR_NONE。

实战:错误码的获取、检查与解读

了解返回码列表只是第一步,更重要的是在代码中正确获取和解读错误码。CANN Runtime 的异常处理接口详见 13 异常处理,主要包括:

  • aclGetRecentErrMsg():获取并清空与接口在同一进程或线程中的其它 ACL 接口调用失败时的错误描述信息,建议在每次 ACL 接口调用失败后调用,否则可能导致错误信息堆积、丢失;同进程或线程中多次调用后,只有最后一次返回的字符串指针有效。
  • aclrtPeekAtLastError(aclrtLastErrLevel level):获取当前线程的 Runtime 错误码,仅获取但不清空错误码;level 当前仅支持线程级别(ACL_RT_THREAD_LEVEL)。
  • aclrtGetLastError(aclrtLastErrLevel level):获取当前线程的 Runtime 错误码,获取后清空,之后在无新增错误前获取到的是 ACL_SUCCESS。
  • aclrtGetErrorVerbose(int32_t deviceId, aclrtErrorInfo *errorInfo):在发生设备故障后获取详细错误信息,必须在获取故障事件之后、提交任务中止之前调用;aclrtRepairError 则基于其返回的 aclrtErrorInfo 进行故障恢复,应在提交任务中止之后调用。

仓库中的可运行示例 example/0_quickstart/1_error_handling/main.cpp 演示了这套错误诊断模式的完整写法(其 README 见 example/0_quickstart/1_error_handling/README.md)。核心思路是用一个宏统一检查每个 ACL 接口的返回值:

#define CHECK_ACL_RETURN(call)                                                \
    do {                                                                      \
        aclError ret = (call);                                                \
        if (ret != ACL_SUCCESS) {                                             \
            ERROR_LOG("%s failed: ret=%d", #call, static_cast<int32_t>(ret)); \
            return -1;                                                        \
        }                                                                     \
    } while (0)

在预期会失败的调用(例如 aclrtGetRunMode(nullptr) 触发参数校验失败)之后,组合使用多个诊断接口,先"窥视"(peek)再"取走"(get),最后通过 aclGetRecentErrMsg 拿到文本化错误描述:

aclError expectedRet = aclrtGetRunMode(nullptr);
if (expectedRet == ACL_SUCCESS) {
    WARN_LOG("Expected aclrtGetRunMode(nullptr) to fail, but it succeeded");
} else {
    aclError peekError = aclrtPeekAtLastError(ACL_RT_THREAD_LEVEL);   // 仅获取,不清空
    aclError lastError = aclrtGetLastError(ACL_RT_THREAD_LEVEL);      // 获取并清空
    const char *recentErrMsg = aclGetRecentErrMsg();                  // 获取错误描述文本
    ERROR_LOG("Diagnostics: ret=%d, peekErr=%d, lastErr=%d, recentErrMsg=%s",
        static_cast<int32_t>(expectedRet), static_cast<int32_t>(peekError),
        static_cast<int32_t>(lastError), SafeString(recentErrMsg));
    PrintVerboseErrorInfo(deviceId);   // aclrtGetErrorVerbose 预留接口,失败仅告警
}

该示例的预期输出展示了错误码的"消费"语义——诊断信息被读取一次后即被清空:

[INFO]  ACL init and set device successfully
[INFO]  Current run mode: ACL_HOST
[INFO]  Triggering an expected invalid-parameter error with aclrtGetRunMode(nullptr)
[ERROR] Diagnostics: ret=..., peekErr=..., lastErr=..., recentErrMsg=...
[INFO]  Verbose error info: errorType=..., tryRepair=..., hasDetail=...
[INFO]  After diagnostics are consumed once: peekErr=0, lastErr=0, recentErrMsg=<null>

关于异步错误的处理,FAQ 文档 如何获取和解读Runtime异步错误码 给出了重要提醒:Runtime 异步接口(如 aclrtMemcpyAsync、Kernel Launch)返回成功仅表示任务在 Host 侧下发成功,Device 侧的实际执行结果需要靠同步接口(如 aclrtSynchronizeStream)或错误查询接口来获取。典型的异步执行失败日志为 ret=507015, aicore exception,对应上文表 2 中的 ACL_ERROR_RT_AICORE_EXCEPTION(AI Core 执行异常)。建议的处理手段包括:

  1. 异步下发后立即调用 aclrtSynchronizeStream 同步并检查错误码;
  2. 通过 aclrtPeekAtLastError/aclrtGetLastError 查询线程级错误状态;
  3. 结合 aclrtSetStreamFailureMode(stream, ACL_STOP_ON_FAILURE) 配置"遇错即停"模式,在首个错误发生时即停止执行,避免后续错误覆盖首次错误信息、便于定位根因。

小结

aclError 返回码是 CANN Runtime 应用开发中最重要的诊断信号之一。通过本指南可以掌握三点核心能力:一是根据返回码最高位(1/2/3/5)快速判断错误类别与责任方;二是对照本文的三大完整列表(ACL 通用、透传 RUNTIME、透传 GE)精确匹配错误码并参考其解决方法;三是利用 aclrtPeekAtLastError、aclrtGetLastError、aclGetRecentErrMsg 等接口在代码中主动获取和消费错误信息,结合遇错即停模式定位异步执行失败。相关定义与示例均可直接查阅仓库内的 acl_base_rt.h、rt_error_codes.h、ge_error_codes.h 及 1_error_handling 示例 进行验证与实践。

登录后查看全文
runtime