CANN Runtime 算子编译失败错误码 E20001（Compilation_Error）的定位与排查指南

CANN Runtime 算子编译失败错误码 E20001Compilation_Error的定位与排查指南【免费下载链接】runtime本项目提供CANN运行时组件和维测功能组件。项目地址: https://gitcode.com/cann/runtime导读E20001 是 CANN 图编译前端FEFrontend在算子编译阶段上报的编译失败错误码报错信息中携带算子名称与算子类型两个关键占位符用于快速锁定是哪个算子、哪类算子编译未通过。本文以 CANN runtime 开源仓库中 E20001-Compilation_Error.md 为主体结合仓库内错误码配置与上报机制的源码实现完整说明该错误码的报错格式、可能原因、排查路径以及错误码从上报到输出的底层原理帮助开发者在遇到自定义算子或内置算子编译失败时快速定位问题。一、错误码在 CANN 错误码体系中的位置CANN 的错误码文档按错误来源划分了多个分类E20001 属于FE Errors图编译前端错误分类。在仓库中该分类下还包含其他与编译、配置、参数校验、文件操作相关的错误码完整清单见 FE-Errors.md错误码错误标题典型触发场景E20001Compilation_Error算子编译失败E20002Config_Error_Invalid_Environment_Variable环境变量取值非法E20003Config_Error配置文件内容或格式非法E20007Compilation_Error_Execute_Fusion_Pass图融合 pass 执行失败E20101 / E20103Invalid_Argument参数校验失败E21001 / E21002File_Operation_Error文件打开/解析失败E22001Compilation_Error另一类编译错误场景其中 E20001 与 E22001 均以 Compilation_Error 命名但 E20001 聚焦于算子本身的编译过程是本文讲解的主题。二、错误信息格式解析2.1 报错模板与占位符含义E20001 的报错格式固定为Operator %s compilation failed. Optype is %s.其中两个%s占位符按出现顺序依次被替换为算子名称op name编译失败算子在计算图中的具体实例名称算子类型op type该算子所属的算子类型标识。该格式与仓库中 error_code.json 的配置完全一致{ errClass: FE Errors, errTitle: Compilation_Error, ErrCode: E20001, ErrMessage: Operator %s compilation failed. Optype is %s., Arglist: pass_name,pass_type, suggestion: { Possible Cause: 1. The operator has an invalid argument. 2. The operator implementation logic is abnormal., Solution: For a custom operator, check the operator implementation and arguments based on the error log. For a Huawei built-in operator, obtain the host log and contact technical support at https://www.hiascend.com/support. } }从配置可以看到该错误码在文档中的 Possible Cause可能原因与 Solution解决方法正是源自这份错误码定义文件二者一一对应。2.2 报错示例原文档给出的典型示例Operator QuantBatchMatmulV3 compilation failed. Optype is QuantBatchMatmulV3.即名为QuantBatchMatmulV3的算子类型同为QuantBatchMatmulV3在编译阶段失败。实际场景中两个字段可能不一致例如算子实例名为add_1、算子类型为Add因此排查时应同时关注这两个信息并通过算子名称在模型/图中定位具体节点。三、可能原因分析根据错误码定义文件与 E20001-Compilation_Error.mdE20001 的触发原因主要有两类算子参数无效invalid argument传入算子的输入张量形状、数据类型、属性attr等不符合该算子的约束定义。例如QuantBatchMatmulV3这类量化算子对输入 dtype、量化参数有严格要求一旦 shape 或 dtype 不满足 TBE/Ascend IR 算子定义中的校验条件编译前端在构图/编译阶段就会拒绝并上报 E20001。算子实现逻辑异常implementation logic is abnormal算子内核实现kernel 代码、tiling 逻辑在编译过程中出现内部错误例如代码中对不支持的输入组合未做处理、tiling 计算越界、资源估算失败等。需要说明的是E20001 上报的是编译阶段的失败结论具体失败细节需要结合错误日志进一步确认——占位符只告诉你是哪个算子编译失败而为什么失败要下沉到日志中的异常栈与详细错误信息中定位。四、排查步骤与解决方法原文档对排查路径的划分非常明确根据算子来源自定义算子 / 内置算子采用不同策略。4.1 自定义算子检查算子实现与参数对于用户自研的自定义算子Custom Operator建议按以下顺序排查核对算子注册信息检查算子原型Op Proto定义中的输入/输出数量、属性默认值以及算子注册的 dtype/shape 约束是否与实际使用一致。核对调用参数回到模型/脚本中检查传给该算子的张量 dtype、shape、format 与属性值确认没有超出实现支持范围。检查算子 kernel 与 tiling 实现重点检查是否有未覆盖的输入分支、是否存在除零/越界/空指针等实现缺陷可先以最简单的合法输入组合验证算子本身能否编译通过。结合错误日志逐层定位编译失败时日志中通常会带出底层异常信息如 TBE 编译报错、内核代码语法错误等据此修正实现后重新编译。4.2 内置算子获取 Host 日志并反馈如果报错算子为华为内置算子Built-in Operator则通常不是用户代码可修正的范围。此时应按原文档建议收集完整的Host 日志Host 侧日志是定位 FE 编译问题的主要依据日志查看方式可参考 Host 日志查看指南 与 如何通过 plog 日志定位 Device 侧异常将报错信息、Host 日志与复现信息一并提供给技术支持。五、源码级原理E20001 从上报到输出的机制E20001 的文案与原因/解决建议并非硬编码在业务代码中而是由错误管理组件统一维护。理解这一机制有助于判断日志里为什么会出现这些字段以及如何扩展定位信息。5.1 错误码定义统一存放在 JSON 配置如上文所示E20001 定义位于 error_code.json 的error_info_list数组。该文件包含全量错误码的ErrCode、ErrMessage、Arglist、suggestionPossible Cause / Solution字段运行时由 ErrorManager 解析并缓存在内存映射error_map_中见 error_manager.cc 的ParseJsonFormatString实现。5.2 占位符如何被替换E20001 的两个%s占位符由Arglist字段声明参数名列表。上报时调用方传入错误码 参数名/参数值映射ErrorManager 的ReportErrMessage会按Arglist中的参数顺序依次把ErrMessage模板中的%s替换为实际值见 error_manager.ccfor (const std::string arg : error_info.arg_list) { ... const auto index error_message.find(%s); ... (void)error_message.replace(index, kLength, arg_value); }也就是说日志中看到的Operator QuantBatchMatmulV3 compilation failed. Optype is QuantBatchMatmulV3.正是E20001模板依次填入算子名与算子类型后的最终文案。5.3 错误信息最终输出格式ErrorManager 在GetErrorMessage中会按统一格式组织输出包含错误码、时间戳、错误标题、错误信息以及非空的 Possible Cause 与 Solution 字段见 error_manager.cc[PID: xxx] report_time errTitle(errCode): error_message Possible Cause: ... Solution: ...因此开发者实际看到的 E20001 报错段落中除了那句Operator %s compilation failed.之外往往还会附带与之配套的可能原因与解决建议文本排查时可以直接参考。5.4 上报入口从调用侧看图编译前端通过ATCReportErrMessage(error_code, key, value)见 error_manager.h 与 error_manager.cc传入错误码与参数向量再由ReportErrMessage完成模板替换与错误项记录最终经GetErrorMessage/OutputErrMessage输出到用户侧。六、与相近错误码的区分排查时容易将 E20001 与以下错误码混淆建议先根据报错上下文区分E20007 Compilation_Error_Execute_Fusion_Pass报错格式为Graph fusion pass %s failed. The pass type is %s.对应的是图融合 pass 执行失败而非单个算子编译失败定义同样位于 error_code.jsonE22001 Compilation_Error属于另一类编译错误场景见 E22001-Compilation_Error.mdE20101 / E20103 Invalid_Argument参数校验阶段直接失败的错误码与编译阶段失败不同但触发根因可能与算子参数非法重叠可相互参考。判定的最简单标准是看报错文案关键词Operator ... compilation failed对应 E20001fusion pass ... failed对应 E20007。七、总结E20001 是 CANN 图编译前端对算子编译失败的统一定义错误码其价值在于通过算子名称与算子类型两个占位符把失败范围精确到单个算子节点。排查时先通过Operator name compilation failed. Optype is type.定位失败算子再区分自定义算子检查算子原型、参数、kernel/tiling 实现与内置算子收集 Host 日志、联系技术支持两条路径如需深入机制可阅读 error_code.json 中的错误码定义与 error_manager.cc 中的模板替换、输出编排逻辑理解报错文本每个字段的来源。错误码文档全集可参考 FE-Errors 文档目录 与 错误码参考 README在遇到其他编译、参数、配置类错误时对照排查。【免费下载链接】runtime本项目提供CANN运行时组件和维测功能组件。项目地址: https://gitcode.com/cann/runtime创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考