Ascend C 算子运行时错误调试

系统化调试 Ascend C 算子运行时错误，包括错误码处理、环境检查。

快速诊断

运行时错误
    │
    ├─ 返回码非0？
    │   ├─ 161xxx → 参数错误 → 见高频错误速查
    │   ├─ 361xxx → Runtime错误 → 见 debug_workflow.md
    │   ├─ 507035 → 向量核异常 → 见 debug_workflow.md#507035-向量核异常
    │   └─ 561xxx → 内部错误 → 见高频错误速查 / debug_workflow.md
    │
    └─ 复杂场景 → 开启日志调试

高频错误速查

错误码	类型	排查方向	详细方案
507035	向量核异常	检查 UB 端地址 32B 对齐（含 VEC 指令操作数）/ GM→UB padParams 违规 / UB 溢出	debug_workflow.md
161xxx	参数错误	检查 dtype/shape/nullptr	debug_workflow.md
561002	Tiling错误	检查 TilingKey/TilingFunc	debug_workflow.md
561003	Kernel未找到	检查算子安装/环境配置	debug_workflow.md

更多错误码见 error_codes.md

未知错误码处理

遇到速查表中未列出的错误码时，见 debug_workflow.md

调试工具速查

工具	用途	使用
aclGetRecentErrMsg()	获取错误详情	返回码非0时调用
环境检查	ascendc-env-check skill	见 skill:ascendc-env-check
parse_plog.py	日志解析	python3 scripts/parse_plog.py [plog_file]
ASCEND_SLOG_PRINT_TO_STDOUT=1	日志打屏	实时查看日志

详细调试方法见 debug_workflow.md

详细资源

• debug_workflow.md：详细调试流程（错误码处理、环境检查）
• kernel_binary_debug.md：Kernel 二进制构建调试（编译缓存、SEL匹配、多版本冲突、opParaSize）
• error_codes.md：完整错误码表（基本状态码、内部异常状态码）
• ascendc-env-check skill：环境变量配置指南