external-gitcode-ascend-atb-debug-guide

name	external-gitcode-ascend-atb-debug-guide
description	ATB 调试指南技能。当用户遇到 ATB 算子测试问题、需要分析错误原因、或需要了解 ATB 环境配置时调用此技能。 覆盖：环境配置问题、ABI版本不匹配、内存错误、CSV测试失败、ACLNN接口问题等常见场景。
keywords	["atb","debug","error","troubleshooting","昇腾","NPU","调试","aclnn","moe"]
metadata	{"author":"ascend-transformer-boost-team + Claude Code + opus4.7","version":"1.1.1","created":"2026-04-19","updated":"2026-04-28","skill-type":"debug"}
original-name	atb-debug-guide
synced-from	https://gitcode.com/Ascend/agent-skills
synced-date	2026-05-26
synced-commit	1f7666e7768a0ceb21bb1d40ce4b5179fcb6f1d6
license	UNKNOWN

ATB Debug Guide

功能概述

提供 ATB 调试指南，覆盖环境配置问题、ABI版本不匹配、内存错误、CSV测试失败、ACLNN接口问题等常见场景。

调用时机

在以下情况下调用此技能：

• 用户遇到 ATB 算子测试问题
• 用户需要分析错误原因
• 用户需要了解 ATB 环境配置

⚠️ 路径约束（必须执行）

执行此技能前，必须从用户处获取以下路径（如未提供则使用默认路径）：

• <CANN_PATH>: CANN 安装路径（如 /usr/local/Ascend/cann-9.0.0-beta.2）
• <ATB_REPO_PATH>: ATB 仓库路径

---

索引

问题类型	快速定位
ABI版本不匹配	undefined symbol, shared object file
内存错误	ERROR_OUT_OF_HOST_MEMORY
Tensor维度错误	ERROR_INVALID_TENSOR_DIM
数据类型错误	KeyError: 'float32', ERROR_INVALID_TENSOR_INI_MATCH
ACLNN函数签名错误	161001, 161002, undefined symbol
ACLNN MoE场景不匹配	{xxx}Quant 等非MoE算子
日志分析方法	plog日志, atb日志

---

常见错误分类

ABI 版本不匹配错误

错误信息

OSError: /path/to/atb/output/atb/cxx_abi_0/lib/libatb_test_framework.so: cannot open shared object file

或

undefined symbol: _ZN3atb13OpParamToJson...

原因

ATB 输出目录有两个 ABI 版本：

• cxx_abi_0: 旧版本（g++/libstdc++abi_0）
• cxx_abi_1: 新版本（g++/libstdc++abi_1）

测试框架库和依赖库必须使用相同 ABI 版本。

解决方案

方案A：使用正确的 set_env.sh 参数

source <CANN_PATH>/set_env.sh
source <ATB_REPO_PATH>/output/atb/set_env.sh --cxx_abi=1
echo $ATB_HOME_PATH