CANN opbase 算子错误码 EZ0023 深度解析多参数 Tensor 数量校验失败Invalid_Argument的定位与修复【免费下载链接】opbase本项目是CANN算子库的基础框架库为算子提供公共依赖文件和基础调度能力。项目地址: https://gitcode.com/cann/opbase本文基于 CANN opbase 仓库算子库基础框架库的官方错误码文档深入解读算子错误 EZ0023Invalid_Argument的报错格式、占位符语义与解决思路并结合 log.h 中的OP_LOGE_FOR_INVALID_TENSORNUMS_WITH_REASON宏与 log.cpp 中的错误码注册表从源码层面还原该错误从触发、记录到上报的完整链路。读完本文你将掌握多参数 Tensor 数量校验失败的报错判读方法并能在自研算子或 aclnn 接口中正确使用 EZ0023 对应的日志宏。EZ0023 是什么EZ0023 是 CANN opbase 算子错误Operator Errors家族中的一个预定义错误码错误标题为Invalid_Argument。它用于标识一种典型的算子参数合法性校验失败场景算子的多个参数input/output tensor数量不符合算子约束并且在报错时需要附带具体的原因说明。在 CANN 的算子开发流程中算子或 aclnn 接口实现方负责对入参进行前置校验校验不通过时需要输出 ERROR 级别日志并上报对应的错误码方便上层框架如 GE 图引擎与用户快速定位问题。EZ0023 对应的是“多参数 Tensor 数量同时出错”这一细分场景与它相邻的 EZ0022单参数 Tensor 数量错误共同构成 Tensor 数量校验的完整错误码体系。完整的算子错误码清单可查看 Operator-Errors.md。错误信息格式解析EZ0023 的报错格式在官方文档中定义如下Parameters %s of %s have invalid tensor nums %s. Reason: %s.其中四个占位符%s依次表示占位符含义示例值第 1 个%s参数名可同时列出多个参数lse and go第 2 个%s算子名或接口名AttentionUpdate第 3 个%stensor 数量错误值各参数实际数量4 and 4第 4 个%s报错原因The number of tensors in input lse and go should be twice the attr sp, where sp is 2.该格式与 log.cpp 中 EZ0023 错误码注册表完全一致{ errClass: Operator Errors, errTitle: Invalid_Argument, ErrCode: EZ0023, ErrMessage: Parameters %s of %s have invalid tensor nums %s. Reason: %s., Arglist: param_names, op_name, incorrect_nums, reason, suggestion: { Possible Cause: N/A, Solution: Check whether the number of tensors in the input tensor lists meets the conditions. } }注册表中的Arglist字段进一步明确了错误上报时携带的结构化字段param_names参数名、op_name算子名或接口名、incorrect_nums错误的 tensor 数量、reason原因。这也意味着 EZ0023 不仅输出一条可读的日志文本还会以键值对形式上报结构化错误上下文。报错示例逐字拆解官方文档给出的报错示例如下Parameters lse and go of AttentionUpdate have invalid tensor nums 4 and 4. Reason: The number of tensors in input lse and go should be twice the attr sp, where sp is 2.逐段解读Parameters lse and go出错的参数是lse和go两个输入 tensorof AttentionUpdate所属算子为AttentionUpdatehave invalid tensor nums 4 and 4lse与go的实际 tensor 数量分别为 4 和 4均不满足要求Reason: The number of tensors in input lse and go should be twice the attr sp, where sp is 2.原因描述为——lse和go的 tensor 数量应为属性sp的两倍而当前sp的取值为 2即期望数量为 4 的两倍关系不成立此处实际数量 4 与2 * sp 4的约束冲突点在于校验逻辑要求数量严格为sp的 2 倍具体约束由算子实现定义。可见该错误信息将“哪些参数错了”“错了多少”“为什么错”三者一次说清使用者无需再翻阅算子定义即可初步定位到参数数量层面的问题。源码级原理EZ0023 对应的日志宏在 CANN opbase 中EZ0023 并非由公共框架直接抛出而是由算子或 aclnn 实现通过日志宏主动上报。对应宏为 log.h 中定义的OP_LOGE_FOR_INVALID_TENSORNUMS_WITH_REASON#define OP_LOGE_FOR_INVALID_TENSORNUMS_WITH_REASON(entityName, paramNames, incorrectNums, reason) \ do { \ std::string _safe_entityName_(entityName); \ std::string _safe_paramNames_(paramNames); \ std::string _safe_incorrectNums_(incorrectNums); \ std::string _safe_reason_(reason); \ OP_LOGE_LIBOPAPI_REPORT(_safe_entityName_.c_str(), \ Parameters %s of %s have invalid tensor nums %s. Reason: %s., \ _safe_paramNames_.c_str(), _safe_entityName_.c_str(), \ _safe_incorrectNums_.c_str(), _safe_reason_.c_str()); \ const std::vectorconst char* msgKey {param_names, op_name, incorrect_nums, reason}; \ const std::vectorconst char* msgvalue {_safe_paramNames_.c_str(), _safe_entityName_.c_str(), \ _safe_incorrectNums_.c_str(), _safe_reason_.c_str()}; \ REPORT_PREDEFINED_ERR_MSG(EZ0023, msgKey, msgvalue); \ } while (0)宏的工作机制可分为三步入参安全化将四个入参entityName、paramNames、incorrectNums、reason统一转为std::string避免后续拼接时出现空指针或生命周期问题输出 ERROR 日志调用OP_LOGE_LIBOPAPI_REPORT记录 ERROR 级别日志。从 log.h 的实现可见日志前缀包含源文件、行号、子模块名OP_SUBMOD_NAME、函数名、线程 IDGetTid基于syscall(__NR_gettid)获取以及OpName便于在日志中快速回溯到触发点上报结构化错误调用REPORT_PREDEFINED_ERR_MSG(EZ0023, msgKey, msgvalue)按param_names / op_name / incorrect_nums / reason四个键将错误上下文上报给上层GE 图引擎等实现“日志可读、错误可机读”的双通道输出。值得注意的是该宏的do { ... } while (0)包裹使其可以安全地嵌入if/else分支中同时所有中间字符串均为局部std::string因此支持传入const char*、std::string等任意可转换为字符串的实参类型。宏的完整使用示例OP_LOGE_FOR_INVALID_TENSORNUMS_WITH_REASON.md 给出了该宏的完整调用示例与本文报错示例同源关键代码段如下// 预期输出: Parameters lse and go of AttentionUpdate have invalid tensor nums 4 and 4. // Reason: The number of tensors in input lse and go should be twice the attr sp, where sp is 2. if (lseCount ! sp * 2 || goCount ! sp * 2) { std::string numMsg std::to_string(lseCount) and std::to_string(goCount); OP_LOGE_FOR_INVALID_TENSORNUMS_WITH_REASON(AttentionUpdate, lse and go, numMsg.c_str(), The number of tensors in input lse and go should be twice the attr sp, where sp is 2.); return ge::GRAPH_FAILED; }这段代码展示了 EZ0023 的标准用法模式先通过算子自身的参数约束如lseCount ! sp * 2 || goCount ! sp * 2判断 tensor 数量是否非法将多个参数的实际数量拼接成4 and 4形式传入incorrectNums将多个参数名拼接成lse and go形式传入paramNamesreason中给出精确的期望约束“应为属性 sp 的两倍”为上层提供可操作的修复线索上报后返回失败状态如ge::GRAPH_FAILED终止算子执行。宏的参数语义总结如下宏参数类型说明entityNameconst char*/std::string算子名称或 aclnn 接口名称paramNamesconst char*/std::string出错参数名称列表多参数用and连接incorrectNumsconst char*/std::string各参数实际 tensor 数量列表reasonconst char*/std::string错误原因描述与相邻错误码的区分EZ0022 vs EZ0023Tensor 数量校验相关的错误码有两个使用时需要根据“单参数还是多参数”以及“是否需要附带原因”来选择错误码触发场景对应宏报错格式EZ0022单个参数的 tensor 数量错误且能给出期望数量OP_LOGE_FOR_INVALID_TENSORNUMlog.hParameter %s of %s has invalid tensor num %ld. It should be %s.EZ0023多个参数的 tensor 数量错误需附带原因说明OP_LOGE_FOR_INVALID_TENSORNUMS_WITH_REASONlog.hParameters %s of %s have invalid tensor nums %s. Reason: %s.从实现上看EZ0022 的宏将incorrectNum强转为int64_t后以%ld输出适合单个数量的场景EZ0023 则全部以字符串承接天然支持“4 and 4”这类多值拼接并通过reason承载更丰富的约束语义。二者的错误码注册见 log.cpp 中 EZ0022 与 EZ0023 条目与建议信息也相互呼应EZ0023 的官方建议为检查输入 tensor 列表数量是否满足条件。报错后的定位与解决步骤官方文档给出的解决方法是根据报错原因检查输入或输出 tensor 的数量是否满足条件。落到实际操作中可按以下步骤排查通读Reason字段EZ0023 的优势在于原因内嵌在报错文本中先确认算子对 tensor 数量的期望约束如“应为属性 sp 的两倍”再比对报错中给出的实际数量核对调用侧参数检查调用算子或 aclnn 接口时传入的 tensor 列表长度确认是否存在漏传、多传或按错误语义切分 tensor 的情况核对算子属性若约束与属性相关如示例中的sp确认属性取值是否正确并重新按约束公式计算期望数量对照算子定义阅读算子原型定义op proto中对该参数的约束说明确认是调用方传参错误还是算子实现校验逻辑有误结合结构化上下文在支持错误码结构化上报的环境中可读取param_names、op_name、incorrect_nums、reason四个字段做自动化判题与回归。总结EZ0023Invalid_Argument是 CANN opbase 面向“多参数 tensor 数量校验失败”场景的预定义算子错误码。它通过Parameters %s of %s have invalid tensor nums %s. Reason: %s.一条消息完整承载参数名、算子名、错误数量与失败原因配套的OP_LOGE_FOR_INVALID_TENSORNUMS_WITH_REASON宏log.h在输出 ERROR 日志的同时按param_names / op_name / incorrect_nums / reason四键上报结构化错误与 log.cpp 中的错误码注册表严格对应。算子开发者只需在参数校验分支中按文档示例调用该宏即可让上层框架与用户获得“可读 可机读”的双通道错误信息从而快速定位 tensor 数量层面的参数问题。【免费下载链接】opbase本项目是CANN算子库的基础框架库为算子提供公共依赖文件和基础调度能力。项目地址: https://gitcode.com/cann/opbase创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考