CANN opbase 错误码 EZ0024Invalid_Argument详解参数值非法错误的日志格式、源码实现与排查指南【免费下载链接】opbase本项目是CANN算子库的基础框架库为算子提供公共依赖文件和基础调度能力。项目地址: https://gitcode.com/cann/opbase本篇技术文章围绕 CANN opbase 仓库中算子错误码EZ0024Invalid_Argument展开讲清楚Parameter %s of %s has incorrect value %s. It should be %s. 这一报错格式中四个占位符的确切含义并结合 opbase 日志框架源码log.h、log.cpp说明该错误码是如何被宏OP_LOGE_FOR_INVALID_VALUE触发、拼装和上报的。读完后你能够在日志中快速定位参数值非法类错误读懂四个占位符定位到的参数并对照算子参数约束完成修复同时也能在自研算子或 aclnn 实现中正确使用该校验宏。错误信息格式与占位符含义EZ0024 属于 opbase 错误码体系中 Operator Errors算子错误大类下的Invalid_Argument参数非法子类官方文档见 EZ0024-Invalid_Argument英文 与 EZ0024-Invalid_Argument中文。该错误码的标准报错格式为Parameter %s of %s has incorrect value %s. It should be %s.其中四个%s占位符按出现顺序依次代表顺序占位符含义对应宏形参源码命名含义说明第 1 个参数名parameter nameparamName取值非法的那个参数算子属性/接口参数的名称第 2 个算子名或 API 名operator name or API nameentityName报错的算子名称或调用侧的 aclnn 接口名称第 3 个错误值incorrect valueincorrectValue实际传入的非法参数值第 4 个正确值correct valuecorrectValue参数应当取的值可以是具体值、取值集合也可以是范围描述如in range of [1, 16]这一占位符顺序与源码中的键值定义完全一致。在 log.h 中宏OP_LOGE_FOR_INVALID_VALUE上报时使用的msgKey为const std::vectorconst char* msgKey {param_name, op_name, incorrect_value, correct_value};典型报错示例解读官方文档给出了两个典型报错示例它们覆盖了correctValue的两种常见写法示例 1正确值为有限取值集合Parameter update_type of AttentionUpdate has incorrect value 2. It should be 0 or 1.解读AttentionUpdate算子的参数update_type实际取值为2但该参数合法取值只有0或1。常见于枚举型参数越界例如把模式标志写成了不存在的第 3 种模式。示例 2正确值为取值范围Parameter sp of operator AttentionUpdate has incorrect value 17. It should be in range of [1, 16].解读参数sp通常表示分片数、head 分组数等实际取值为17超出合法区间[1, 16]。可以看到第 4 个占位符并不要求是单个数值写成自然语言的范围描述in range of [1, 16]同样符合格式。错误码的源码级产生机制宏定义OP_LOGE_FOR_INVALID_VALUE在 log.h 中EZ0024 对应的宏定义为宏头注明此接口仅供算子或 aclnn 实现使用/** * EZ0024: Parameter value error (single parameter, with correct value) * entityName:string - 算子名称或aclnn接口名称 * paramName:string - Parameter name * incorrectValue:string - Actual incorrect value * correctValue:string - Expected correct value * errMessage: Parameter [paramName] of [entityName] has incorrect value [incorrectValue]. It should * be [correctValue]. */ #define OP_LOGE_FOR_INVALID_VALUE(entityName, paramName, incorrectValue, correctValue) \ do { \ std::string _safe_entityName_(entityName); \ std::string _safe_paramName_(paramName); \ std::string _safe_incorrectValue_(incorrectValue); \ std::string _safe_correctValue_(correctValue); \ OP_LOGE_LIBOPAPI_REPORT(_safe_entityName_.c_str(), \ Parameter %s of %s has incorrect value %s. It should be %s., \ _safe_paramName_.c_str(), _safe_entityName_.c_str(), \ _safe_incorrectValue_.c_str(), _safe_correctValue_.c_str()); \ const std::vectorconst char* msgKey {param_name, op_name, incorrect_value, correct_value}; \ const std::vectorconst char* msgvalue {_safe_paramName_.c_str(), _safe_entityName_.c_str(), \ _safe_incorrectValue_.c_str(), _safe_correctValue_.c_str()}; \ REPORT_PREDEFINED_ERR_MSG(EZ0024, msgKey, msgvalue); \ } while (0)从源码结构看一次宏展开做了两件事打印 ERROR 日志通过内部的OP_LOGE_LIBOPAPI_REPORT见 log.h调用DlogRecord先经CheckLogLevel(OP_MODULE_ID, DLOG_ERROR)检查日志级别开关再落盘一条带完整上下文的错误日志。日志行前缀格式为[源文件:行号][子模块名][函数名][线程ID] OpName:[算子名] 错误正文其中模块 ID 固定为OP_MODULE_ID 63见 log.h子模块名默认OPS_BASEOP_SUBMOD_NAME宏见 log.h。因此实际看到的 EZ0024 日志大致形如[attention_update.cpp:42][OPS_BASE][InferShape][12345] OpName:[AttentionUpdate] Parameter sp of AttentionUpdate has incorrect value 17. It should be in range of [1, 16].前缀中的源文件与行号能直接把你带回触发校验的代码位置。上报预定义错误码调用REPORT_PREDEFINED_ERR_MSG(EZ0024, msgKey, msgvalue)把四个键值对按param_name / op_name / incorrect_value / correct_value的键序打包上报供上层框架按错误码聚合与检索。四个实参均先被拷贝进局部std::string_safe_*_变量因此支持const char*、char*、std::string三种传入类型也避免了临时字符串失效的问题。错误码模板的注册宏上报所用的错误码模板在 log.cpp 内置的g_msgJSON 中注册{ errClass: Operator Errors, errTitle: Invalid_Argument, ErrCode: EZ0024, ErrMessage: Parameter %s of %s has incorrect value %s. It should be %s., Arglist: param_name, op_name, incorrect_value, correct_value, suggestion: { Possible Cause: N/A, Solution: Check whether the parameter value is correct. } }该整表通过REG_FORMAT_ERROR_MSG(g_msg.c_str(), g_msg.length())见 log.cpp完成注册。注意Arglist中参数顺序与日志格式串中的占位符顺序严格一一对应这也解释了为什么排查时要按第 1~4 个占位符依次读。排查方法Solution官方文档给出的解决建议是Check whether the parameter value is correct.检查参数值是否正确。基于报错格式的四个占位符建议按以下步骤落地排查解析报错四元组从日志中依次读出哪个算子/API 的哪个参数、实际值是什么、正确值应该是什么。示例 2 中即算子AttentionUpdate、参数sp、实际值17、应为[1, 16]区间内。定位取值来源sp、update_type这类参数一般来自算子属性attr或 aclnn 接口入参。检查模型转换/图构建阶段传入的属性值以及上游代码中对该参数的赋值逻辑。对照参数约束依据该算子的算子说明参数合法取值、区间、枚举定义核对正确值。若correctValue写的是范围确认实际值是否越界若是枚举集合确认是否使用了未定义的值。借助日志前缀定位代码利用 EZ0024 日志前缀中的源文件:行号和OpName直接定位到算子侧触发OP_LOGE_FOR_INVALID_VALUE的校验点确认该校验条件与预期是否一致偶发情况下也可能是校验逻辑本身写错。一个可参考的校验代码模式摘自 OP_LOGE_FOR_INVALID_VALUE 接口文档// 预期输出: Parameter sp of AttentionUpdate has incorrect value 17. It should be // in range of [1, 16]. if (sp_ 1 || sp_ 16) { OP_LOGE_FOR_INVALID_VALUE(AttentionUpdate, sp, std::to_string(sp_), in range of [1, 16]); return ge::GRAPH_FAILED; }要点报错后应返回失败状态如ge::GRAPH_FAILED中断当前 InferShape/校验流程避免非法参数继续向下传递。宏使用规范与相邻错误码辨析宏使用规范接口细节功能说明、参数表、示例参见 OP_LOGE_FOR_INVALID_VALUE参数名输入/输出说明entityName输入算子名称或 aclnn 接口名称支持const char*或std::stringparamName输入参数名称支持const char*或std::stringincorrectValue输入实际参数值支持const char*或std::stringcorrectValue输入预期参数值支持const char*或std::string返回值无。约束说明无仅限算子或 aclnn 实现内部使用。与相邻 EZ0xxx 错误码的区分EZ0024 处在 opbase 参数校验错误码族的中间位置容易与相邻错误码混淆。对照 log.h 与 log.cpp 中的定义错误码报错格式适用场景EZ0022Parameter %s of %s has invalid tensor num %ld. It should be %s.单个参数tensor 列表的个数错误EZ0023Parameters %s of %s have invalid tensor nums %s. Reason: %s.多个参数tensor 列表个数错误带原因EZ0024Parameter %s of %s has incorrect value %s. It should be %s.单个参数参数值错误且能给出正确值EZ0025Parameter %s of %s has incorrect element nums %s. It should be %s.单个参数列表元素个数错误EZ0026Parameter %s of %s has incorrect value %s. Reason: %s.单个参数参数值错误原因更适合作自然语言描述对应宏OP_LOGE_FOR_INVALID_VALUE_WITH_REASON见 接口文档EZ0027Parameters %s of %s have incorrect values %s. Reason: %s.多个参数参数值错误带原因EZ0037Parameter %s of %s is invalid. Reason: %s.单个参数非法且不便用值来表述选择原则当实际值 正确值都能明确表述时选 EZ0024当问题成因复杂、无法用单一正确值概括时应改用 EZ0026/EZ0027 的Reason形式涉及 tensor 列表数量则选 EZ0022/EZ0023/EZ0025。小结EZ0024 是 opbase 中单个参数值非法且可给出正确值场景的标准错误码报错格式固定为Parameter %s of %s has incorrect value %s. It should be %s.四个占位符依次为参数名、算子名或 API 名、错误值、正确值。该报错由 log.h 中的OP_LOGE_FOR_INVALID_VALUE宏触发先经OP_LOGE_LIBOPAPI_REPORT打印带文件/行号/线程/算子名上下文的 ERROR 日志再通过REPORT_PREDEFINED_ERR_MSG(EZ0024, ...)上报错误码模板注册于 log.cpp。排查时按解析四元组 → 定位参数来源 → 对照算子参数约束 → 借日志前缀回到校验代码四步进行自研算子中使用时报错后应返回ge::GRAPH_FAILED等失败状态以中断流程。【免费下载链接】opbase本项目是CANN算子库的基础框架库为算子提供公共依赖文件和基础调度能力。项目地址: https://gitcode.com/cann/opbase创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
CANN opbase 错误码 EZ0024Invalid_Argument详解参数值非法错误的日志格式、源码实现与排查指南【免费下载链接】opbase本项目是CANN算子库的基础框架库为算子提供公共依赖文件和基础调度能力。项目地址: https://gitcode.com/cann/opbase本篇技术文章围绕 CANN opbase 仓库中算子错误码EZ0024Invalid_Argument展开讲清楚Parameter %s of %s has incorrect value %s. It should be %s. 这一报错格式中四个占位符的确切含义并结合 opbase 日志框架源码log.h、log.cpp说明该错误码是如何被宏OP_LOGE_FOR_INVALID_VALUE触发、拼装和上报的。读完后你能够在日志中快速定位参数值非法类错误读懂四个占位符定位到的参数并对照算子参数约束完成修复同时也能在自研算子或 aclnn 实现中正确使用该校验宏。错误信息格式与占位符含义EZ0024 属于 opbase 错误码体系中 Operator Errors算子错误大类下的Invalid_Argument参数非法子类官方文档见 EZ0024-Invalid_Argument英文 与 EZ0024-Invalid_Argument中文。该错误码的标准报错格式为Parameter %s of %s has incorrect value %s. It should be %s.其中四个%s占位符按出现顺序依次代表顺序占位符含义对应宏形参源码命名含义说明第 1 个参数名parameter nameparamName取值非法的那个参数算子属性/接口参数的名称第 2 个算子名或 API 名operator name or API nameentityName报错的算子名称或调用侧的 aclnn 接口名称第 3 个错误值incorrect valueincorrectValue实际传入的非法参数值第 4 个正确值correct valuecorrectValue参数应当取的值可以是具体值、取值集合也可以是范围描述如in range of [1, 16]这一占位符顺序与源码中的键值定义完全一致。在 log.h 中宏OP_LOGE_FOR_INVALID_VALUE上报时使用的msgKey为const std::vectorconst char* msgKey {param_name, op_name, incorrect_value, correct_value};典型报错示例解读官方文档给出了两个典型报错示例它们覆盖了correctValue的两种常见写法示例 1正确值为有限取值集合Parameter update_type of AttentionUpdate has incorrect value 2. It should be 0 or 1.解读AttentionUpdate算子的参数update_type实际取值为2但该参数合法取值只有0或1。常见于枚举型参数越界例如把模式标志写成了不存在的第 3 种模式。示例 2正确值为取值范围Parameter sp of operator AttentionUpdate has incorrect value 17. It should be in range of [1, 16].解读参数sp通常表示分片数、head 分组数等实际取值为17超出合法区间[1, 16]。可以看到第 4 个占位符并不要求是单个数值写成自然语言的范围描述in range of [1, 16]同样符合格式。错误码的源码级产生机制宏定义OP_LOGE_FOR_INVALID_VALUE在 log.h 中EZ0024 对应的宏定义为宏头注明此接口仅供算子或 aclnn 实现使用/** * EZ0024: Parameter value error (single parameter, with correct value) * entityName:string - 算子名称或aclnn接口名称 * paramName:string - Parameter name * incorrectValue:string - Actual incorrect value * correctValue:string - Expected correct value * errMessage: Parameter [paramName] of [entityName] has incorrect value [incorrectValue]. It should * be [correctValue]. */ #define OP_LOGE_FOR_INVALID_VALUE(entityName, paramName, incorrectValue, correctValue) \ do { \ std::string _safe_entityName_(entityName); \ std::string _safe_paramName_(paramName); \ std::string _safe_incorrectValue_(incorrectValue); \ std::string _safe_correctValue_(correctValue); \ OP_LOGE_LIBOPAPI_REPORT(_safe_entityName_.c_str(), \ Parameter %s of %s has incorrect value %s. It should be %s., \ _safe_paramName_.c_str(), _safe_entityName_.c_str(), \ _safe_incorrectValue_.c_str(), _safe_correctValue_.c_str()); \ const std::vectorconst char* msgKey {param_name, op_name, incorrect_value, correct_value}; \ const std::vectorconst char* msgvalue {_safe_paramName_.c_str(), _safe_entityName_.c_str(), \ _safe_incorrectValue_.c_str(), _safe_correctValue_.c_str()}; \ REPORT_PREDEFINED_ERR_MSG(EZ0024, msgKey, msgvalue); \ } while (0)从源码结构看一次宏展开做了两件事打印 ERROR 日志通过内部的OP_LOGE_LIBOPAPI_REPORT见 log.h调用DlogRecord先经CheckLogLevel(OP_MODULE_ID, DLOG_ERROR)检查日志级别开关再落盘一条带完整上下文的错误日志。日志行前缀格式为[源文件:行号][子模块名][函数名][线程ID] OpName:[算子名] 错误正文其中模块 ID 固定为OP_MODULE_ID 63见 log.h子模块名默认OPS_BASEOP_SUBMOD_NAME宏见 log.h。因此实际看到的 EZ0024 日志大致形如[attention_update.cpp:42][OPS_BASE][InferShape][12345] OpName:[AttentionUpdate] Parameter sp of AttentionUpdate has incorrect value 17. It should be in range of [1, 16].前缀中的源文件与行号能直接把你带回触发校验的代码位置。上报预定义错误码调用REPORT_PREDEFINED_ERR_MSG(EZ0024, msgKey, msgvalue)把四个键值对按param_name / op_name / incorrect_value / correct_value的键序打包上报供上层框架按错误码聚合与检索。四个实参均先被拷贝进局部std::string_safe_*_变量因此支持const char*、char*、std::string三种传入类型也避免了临时字符串失效的问题。错误码模板的注册宏上报所用的错误码模板在 log.cpp 内置的g_msgJSON 中注册{ errClass: Operator Errors, errTitle: Invalid_Argument, ErrCode: EZ0024, ErrMessage: Parameter %s of %s has incorrect value %s. It should be %s., Arglist: param_name, op_name, incorrect_value, correct_value, suggestion: { Possible Cause: N/A, Solution: Check whether the parameter value is correct. } }该整表通过REG_FORMAT_ERROR_MSG(g_msg.c_str(), g_msg.length())见 log.cpp完成注册。注意Arglist中参数顺序与日志格式串中的占位符顺序严格一一对应这也解释了为什么排查时要按第 1~4 个占位符依次读。排查方法Solution官方文档给出的解决建议是Check whether the parameter value is correct.检查参数值是否正确。基于报错格式的四个占位符建议按以下步骤落地排查解析报错四元组从日志中依次读出哪个算子/API 的哪个参数、实际值是什么、正确值应该是什么。示例 2 中即算子AttentionUpdate、参数sp、实际值17、应为[1, 16]区间内。定位取值来源sp、update_type这类参数一般来自算子属性attr或 aclnn 接口入参。检查模型转换/图构建阶段传入的属性值以及上游代码中对该参数的赋值逻辑。对照参数约束依据该算子的算子说明参数合法取值、区间、枚举定义核对正确值。若correctValue写的是范围确认实际值是否越界若是枚举集合确认是否使用了未定义的值。借助日志前缀定位代码利用 EZ0024 日志前缀中的源文件:行号和OpName直接定位到算子侧触发OP_LOGE_FOR_INVALID_VALUE的校验点确认该校验条件与预期是否一致偶发情况下也可能是校验逻辑本身写错。一个可参考的校验代码模式摘自 OP_LOGE_FOR_INVALID_VALUE 接口文档// 预期输出: Parameter sp of AttentionUpdate has incorrect value 17. It should be // in range of [1, 16]. if (sp_ 1 || sp_ 16) { OP_LOGE_FOR_INVALID_VALUE(AttentionUpdate, sp, std::to_string(sp_), in range of [1, 16]); return ge::GRAPH_FAILED; }要点报错后应返回失败状态如ge::GRAPH_FAILED中断当前 InferShape/校验流程避免非法参数继续向下传递。宏使用规范与相邻错误码辨析宏使用规范接口细节功能说明、参数表、示例参见 OP_LOGE_FOR_INVALID_VALUE参数名输入/输出说明entityName输入算子名称或 aclnn 接口名称支持const char*或std::stringparamName输入参数名称支持const char*或std::stringincorrectValue输入实际参数值支持const char*或std::stringcorrectValue输入预期参数值支持const char*或std::string返回值无。约束说明无仅限算子或 aclnn 实现内部使用。与相邻 EZ0xxx 错误码的区分EZ0024 处在 opbase 参数校验错误码族的中间位置容易与相邻错误码混淆。对照 log.h 与 log.cpp 中的定义错误码报错格式适用场景EZ0022Parameter %s of %s has invalid tensor num %ld. It should be %s.单个参数tensor 列表的个数错误EZ0023Parameters %s of %s have invalid tensor nums %s. Reason: %s.多个参数tensor 列表个数错误带原因EZ0024Parameter %s of %s has incorrect value %s. It should be %s.单个参数参数值错误且能给出正确值EZ0025Parameter %s of %s has incorrect element nums %s. It should be %s.单个参数列表元素个数错误EZ0026Parameter %s of %s has incorrect value %s. Reason: %s.单个参数参数值错误原因更适合作自然语言描述对应宏OP_LOGE_FOR_INVALID_VALUE_WITH_REASON见 接口文档EZ0027Parameters %s of %s have incorrect values %s. Reason: %s.多个参数参数值错误带原因EZ0037Parameter %s of %s is invalid. Reason: %s.单个参数非法且不便用值来表述选择原则当实际值 正确值都能明确表述时选 EZ0024当问题成因复杂、无法用单一正确值概括时应改用 EZ0026/EZ0027 的Reason形式涉及 tensor 列表数量则选 EZ0022/EZ0023/EZ0025。小结EZ0024 是 opbase 中单个参数值非法且可给出正确值场景的标准错误码报错格式固定为Parameter %s of %s has incorrect value %s. It should be %s.四个占位符依次为参数名、算子名或 API 名、错误值、正确值。该报错由 log.h 中的OP_LOGE_FOR_INVALID_VALUE宏触发先经OP_LOGE_LIBOPAPI_REPORT打印带文件/行号/线程/算子名上下文的 ERROR 日志再通过REPORT_PREDEFINED_ERR_MSG(EZ0024, ...)上报错误码模板注册于 log.cpp。排查时按解析四元组 → 定位参数来源 → 对照算子参数约束 → 借日志前缀回到校验代码四步进行自研算子中使用时报错后应返回ge::GRAPH_FAILED等失败状态以中断流程。【免费下载链接】opbase本项目是CANN算子库的基础框架库为算子提供公共依赖文件和基础调度能力。项目地址: https://gitcode.com/cann/opbase创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
