CANN Runtime 错误码 EE1012 Invalid_Argument 定位与处理指南

原创2026-09-18 22:24:131,613 阅读
文章标签:人工智能Ascend任务调度性能剖析

CANN Runtime 错误码 EE1012 Invalid_Argument 定位与处理指南

导读

本文围绕 CANN Runtime 错误码 EE1012(Invalid_Argument,参数非法) 展开,结合 EE1012 官方错误码参考文档 与仓库内真实上报路径(如 IPC Notify 跨 Device 等待、算子二进制读取、Fusion 任务下发等),讲清错误日志格式、占位符语义、常见触发场景与通用排查步骤,并给出可直接定位源码的调用链证据。读完本文,你将能够根据 EE1012 日志中的 Reason 字段快速判断非法参数出现在哪个 API、哪个参数上,并依据函数输入范围与调用关系完成修复。


1. 错误码全景:EE1012 在 RTS-Errors 中的位置

EE1012 属于 RTS Errors(Runtime 软件错误) 类别,错误标题为 Invalid_Argument(参数非法),是 Runtime 接口层最常见的参数校验类错误之一。其定义位于 src/dfx/error_manager/error_code.json,注册信息如下:

字段 值
errClass RTS Errors
errTitle Invalid_Argument
ErrCode EE1012
ErrMessage %s failed. Value %s for %s is invalid. Reason: %s.
Arglist func, value, param, reason

在 Runtime 内部日志体系中,错误码宏定义见 src/runtime/core/inc/common/error_code_meta.h,同样声明了 4 个格式化参数 func / value / param / reason 并追加 ErrorCode=EE1012 尾缀。也就是说,EE1012 的日志文本与文档给出的格式完全一致,说明文档示例即运行时真实输出。

相邻错误码辨析:EE1011 同为 Invalid_Argument,但其消息模板为 Value %s for parameter %s is invalid(多出 parameter 一词),与 EE1012 的模板 Value %s for %s is invalid 不同,定位时请以日志中的 ErrorCode 为准。


2. 错误日志格式与占位符语义

根据 EE1012 文档,错误输出格式如下:

%s failed. Value %s for %s is invalid. Reason: %s.

四个 %s 占位符按顺序分别表示:

  1. error stage(或 API 名称):出错的功能阶段或调用失败的 API 名,例如 NotifyWait、Read binary file;
  2. parameter value:被判定为非法的参数取值,例如 1;
  3. parameter name:非法参数的名字,例如 current deviceId;
  4. expected value:期望值或失败原因说明,通常以 Reason: 开头给出可执行的修复提示。

2.1 文档错误示例

NotifyWait failed. Value 1 for current deviceId is invalid. Reason: The current device cannot deliver Notify Wait, the corresponding Notify Wait must be delivered on the device that creates the IPC Notify.

该示例对应一次 IPC Notify 的跨 Device 误用:在设备 1 上对创建设备不匹配的 IPC Notify 执行 NotifyWait,Runtime 拒绝了这次等待任务下发,并明确指出“Notify Wait 必须下发到创建该 IPC Notify 的设备上”。

2.2 文档给出的解决建议

文档在 Solution 一节给出的通用处置原则是:按照 Reason 字段的提示调整参数取值。在此基础上,error_code.json 对同类别错误(EE1011)补充了更可操作的排查步骤:

  1. 检查函数的输入参数取值范围,确认传入值是否落在合法区间;
  2. 检查函数调用关系,确认参数来源(如 deviceId 是否与创建资源时的设备一致)是否满足前置条件。

这两条原则对 EE1012 同样适用,下文将结合源码给出具体化路径。


3. 源码级触发场景:EE1012 的真实上报路径

为帮助读者“看到即定位”,这里列举仓库内可确认的 EE1012 上报点(均通过 ErrorCode::EE1012 与 RT_ERROR_INVALID_VALUE 成对上报)。

3.1 IPC Notify 跨 Device 等待(文档示例的源码出处)

rtNotifyWait 的底层实现 ApiImpl::NotifyWait 在 src/runtime/api/impl/api_impl.cc 中:

COND_RETURN_AND_MSG_OUTER(
    notify->CheckIpcNotifyDevId() != RT_ERROR_NONE, RT_ERROR_INVALID_VALUE, ErrorCode::EE1012,
    "Waiting for a Notify", dev->Id_(), "current deviceId",
    RtFmtMsg(
        "The device (device_id=%u) cannot deliver the notify wait task."
        " The notify wait task must be delivered on the device (device_id=%u) where the IPC Notify is created",
        dev->Id_(), notify->GetDeviceId()));
  • func = Waiting for a Notify,value = 当前设备号 dev->Id_(),param = current deviceId;
  • 一旦命中,日志会同时打印当前设备号与 IPC Notify 的创建设备号(notify->GetDeviceId()),与文档示例中的“Value 1 for current deviceId”结构完全吻合。

判定逻辑 Notify::CheckIpcNotifyDevId 位于 src/runtime/core/src/notify/notify.cc:仅当 Notify 为 IPC 类型(isIpcNotify_)时执行校验,通过 dev->Driver_()->GetDevicePhyIdByIndex(dev->Id_(), &phyDeviceId) 将逻辑设备号换算为物理设备号,再与创建 IPC Notify 时的物理设备号 phyId_ 比对,不一致即返回 RT_ERROR_INVALID_VALUE。因此该错误的意义是:IPC Notify 只能在创建设备上被等待。

3.2 算子二进制文件读取/解析失败

在 src/runtime/core/src/runtime.cc 与 src/runtime/core/src/kernel/binary_loader.cc 中,算子二进制文件不存在、路径非法或 kernel json 解析失败时,会以 Reading the operator binary file / Read binary file / Parse kernel json file 为 func,以 binPath / jsonFilePath 为 param 上报 EE1012。这类场景提示使用者核对文件路径与文件完整性。

3.3 Fusion 融合算子任务下发参数越界

在 src/runtime/api/impl/api_error_standard_soc.cc 中,融合算子下发时若子任务数(subTaskNum)为 0 或超过 FUSION_SUB_TASK_MAX_NUM、子算子类型越界(subKernelType >= RT_FUSION_END),会以 Fused operator task delivery 为阶段名上报 EE1012,提示开发者检查融合任务的子任务枚举与数量约束。

3.4 捕获内核任务更新属性不匹配

在 src/runtime/core/src/launch/aix_stars.cc(及同构实现 aix_starsv2.cc)中,对已捕获(captured)的内核任务执行更新时,若算子混合类型、函数类型或属性类型与捕获任务不一致,会以 Updating the captured kernel task 上报 EE1012,并携带新旧类型字符串便于对比。


4. 通用排查与处理步骤

综合文档 Solution 与仓库上报点,EE1012 的定位可归纳为以下四步:

  1. 读 Reason:Reason: 之后的内容是 Runtime 给出的直接修复指引(如“必须在创建 IPC Notify 的设备上下发等待任务”),优先按此调整;
  2. 核对参数范围:对照 API 头文件确认传入值的合法区间。例如 deviceId 应小于当前进程可访问的设备总数,timeOut 等计数类参数不可为非法上限值。相关 API 声明可查阅 include/external/acl/acl_rt.h;
  3. 核对调用关系与上下文:对于 IPC 资源(Notify/Event/内存共享等),确认当前 Context/Stream/Device 与资源创建时的设备一致,参考 3.1 节 的物理设备号比对逻辑;对于文件路径类参数,确认文件存在且格式正确;
  4. 关注日志上下文:Runtime 日志(plog)中 EE1012 前后通常伴随 RT_LOG_ERROR 级别的补充信息(如 IPC Notify 的名称、物理设备号),可结合 如何通过plog日志定位Device侧异常 与 如何获取和解读Runtime异步错误码 进一步收敛根因。

5. 相关参考资源

登录后查看全文
runtime