ascend-ai-coding Ascend C 算子卡死/崩溃调试
系统化调试 Ascend C 算子无法运行完的问题，包括程序卡死/挂起、Kernel超时、程序崩溃。
快速诊断
程序无法运行完
│
├─ 程序崩溃？
│ ├─ 启用 coredump → ulimit -c unlimited
│ ├─ 生成 core 文件 → 运行程序
│ └─ GDB 分析 → gdb <exe> <core> → bt / bt full / info locals
│
└─ 程序卡死？
├─ 查看 plog 日志 → 定位卡死位置
├─ 检查 Buffer 配对 → AllocTensor/FreeTensor
├─ 检查同步 → EnQue/DeQue 配对
└─ Kernel 调试 → AscendC::PRINTF / DumpTensor / msDebug
症状-原因速查表
| 症状 | 可能原因 | 诊断方向 |
|---|---|---|
| 程序卡死/超时 | Buffer 未释放 / 死锁 | 检查 AllocTensor/FreeTensor 配对、EnQue/DeQue 配对 |
| 核心超时/挂起 | Buffer 冲突/死锁 | 检查 Alloc / Free 配对 |
| Segmentation Fault | 空指针解引用 / 内存越界 | GDB 分析 coredump → bt 查看调用栈 |
| Abort | 断言失败 / 异常终止 | GDB 分析 coredump → 检查断言条件 |
| 栈溢出 | 递归过深 / 大数组 | 检查 Kernel 内数组大小 |
| aic error | 内存访问越界 / 非对齐访问 | 检查 DataCopy 长度、32B 对齐 |
| AIV 卡死 | 跨核同步缺失 | 检查 CrossCoreWaitFlag 对应 SetFlag |
| drain 卡死 | 未发送 AIV→AIC flag | 检查 flag 发送链路 |
按场景进入详细流程
| 场景 | 说明 | 详细步骤 |
|---|---|---|
| 程序崩溃 | Segmentation Fault / Abort | Coredump 调试 |
| 程序卡死/超时 | Kernel 无响应、挂起 | Kernel 挂起调试 |
| Buffer 冲突/死锁 | Alloc/Free 不配对、同步缺失 | Buffer 问题排查 |
详细资源
- crash_workflow.md：完整调试流程 + 调试工具速查
- parse_plog.py：plog 日志解析脚本（自动识别卡死/崩溃/硬件异常信号）
- ascendc-env-check skill：环境变量配置指南