ascendc-runtime-debug

name	ascendc-runtime-debug
description	Ascend C 算子运行时错误调试技能。用于处理算子运行时问题：(1) aclnn 返回错误码（161xxx/361xxx/561xxx，包括环境配置、Tiling、Kernel 查找等错误），(2) 运行时异常（程序卡死、挂起、超时、内存越界），(3) 需要解析 plog 日志定位问题。触发关键词：运行时错误、错误码、卡死、挂起、超时、Tiling错误、Kernel查找失败、环境变量、plog。

Ascend C 算子运行时错误调试

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

快速诊断

运行时错误
    │
    ├─ 返回码非0？
    │   ├─ 161xxx → 参数错误 → 见高频错误速查
    │   ├─ 361xxx → Runtime错误 → 见 debug_workflow.md
    │   └─ 561xxx → 内部错误 → 见高频错误速查 / debug_workflow.md
    │
    ├─ 程序崩溃？
    │   └─ Coredump → GDB 调试 → 见 debug_workflow.md
    │
    └─ 程序卡死？
        └─ Kernel挂起 → 查看 plog → 见 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	日志打屏	实时查看日志
ulimit -c unlimited	启用 coredump	程序崩溃时生成 core 文件
gdb <exe> <core>	分析 coredump	定位崩溃位置和调用栈

详细调试方法见 debug_workflow.md

详细资源

• debug_workflow.md：详细调试流程（错误码处理、Kernel挂起、环境检查）
• error_codes.md：完整错误码表（基本状态码、内部异常状态码）
• ascendc-env-check skill：环境变量配置指南