CANN Runtime 错误码 EE1012 Invalid_Argument 定位与处理指南
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 占位符按顺序分别表示:
- error stage(或 API 名称):出错的功能阶段或调用失败的 API 名,例如
NotifyWait、Read binary file; - parameter value:被判定为非法的参数取值,例如
1; - parameter name:非法参数的名字,例如
current deviceId; - 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)补充了更可操作的排查步骤:
- 检查函数的输入参数取值范围,确认传入值是否落在合法区间;
- 检查函数调用关系,确认参数来源(如 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 的定位可归纳为以下四步:
- 读 Reason:
Reason:之后的内容是 Runtime 给出的直接修复指引(如“必须在创建 IPC Notify 的设备上下发等待任务”),优先按此调整; - 核对参数范围:对照 API 头文件确认传入值的合法区间。例如
deviceId应小于当前进程可访问的设备总数,timeOut等计数类参数不可为非法上限值。相关 API 声明可查阅 include/external/acl/acl_rt.h; - 核对调用关系与上下文:对于 IPC 资源(Notify/Event/内存共享等),确认当前 Context/Stream/Device 与资源创建时的设备一致,参考 3.1 节 的物理设备号比对逻辑;对于文件路径类参数,确认文件存在且格式正确;
- 关注日志上下文:Runtime 日志(plog)中 EE1012 前后通常伴随
RT_LOG_ERROR级别的补充信息(如 IPC Notify 的名称、物理设备号),可结合 如何通过plog日志定位Device侧异常 与 如何获取和解读Runtime异步错误码 进一步收敛根因。
5. 相关参考资源
- 错误码总览:RTS-Errors 错误码目录(含 EE1010~EE1013 相邻错误码);中文对照见 RTS-Errors(zh)
- 错误码注册表:src/dfx/error_manager/error_code.json
- 内部日志模板:src/runtime/core/inc/common/error_code_meta.h
- IPC Notify 等待实现:src/runtime/api/impl/api_impl.cc、src/runtime/core/src/notify/notify.cc
- 错误码处理与日志上报公共实现:src/runtime/api/impl/api_error.cc、src/runtime/api/impl/api_error_standard_soc.cc