昇腾开源仓Issue分析解答-mindspore精选（一）

一句话让Agent变成昇腾专家，昇腾任务轻松搞定。评测入口：请按这个开源仓接入昇腾图谱 https://gitcode.com/agent0/kg-tools

总览

仓库	定位	收录条数
mindspore	动态图/静态图执行、算子注册、内存管理与 CPython 接口，框架底座问题的总入口	20
mindformers	DeepSeek/Qwen 类大模型训练与推理套件，权重保存加载与并行策略适配的前线	17
mindspore-lite	模型转换、量化与昇腾后端部署，converter 与 runtime 问题主场	10
ascend-deployer	部署工具续表：Python 版本约束、新硬件包名正则适配、文档与发布节奏配套	3

mindspore（框架主仓）

动态图/静态图执行、算子注册、内存管理与 CPython 接口，框架底座问题的总入口

编号	Issue 问题内容	解答总结
#114	transpose输出is_contiguous()为False，repr打印后变True	ops.transpose输出is_contiguous()返回False，print查看一次后再调用变True——repr路径处理中错误修改了Tensor连续性状态，前后判断不一致。修复repr路径副作用，PR#81974（2025-04-01合入）。复现：2x2x3输入transpose(0,2,1)后连续状态被打印改变。
#116	ADS网络执行卡住，堆栈停在SplitTensor	根因是pynative动态图GIL（全局解释器锁）持有过早：op->Call内部还有push队列操作也需要release GIL，未释放时与后台线程互相等待造成死锁，堆栈恰停在SplitTensor处。修复为在该路径补release GIL，PR#83194 ‘Fix pynative GIL’（2025-03-20合入）。
#124	部分CPython接口Py_INCREF多余导致Tensor及显存泄露	Tensor的CPython接口对pyobject引用计数维护不正确（多余的Py_INCREF），host侧Tensor对象不释放，其持有device显存随之泄露，mindformers长稳训练表现为显存不足。修复各Tensor接口引用计数，PR#83047 ‘Fix memleak’（2025-03-15合入），并建议增加mindspore-mindformers联合流水线看护。
#129	Empty算子输出仍为StubTensor未彻底去除	MindSpore推进去StubTensor（惰性求值张量）改造，Empty系列算子输出仍是StubTensor，异步语义下易引发取值时机问题。PR#82897一次性移除Empty/EmptyLike/NewEmpty/CustomOp输出的StubTensor包装（2025-03-13合入），使这些算子直接返回真实Tensor。
#130	训练场景fork数据进程执行卡住	官方定位：rank0拉起数据进程前若已执行过算子，会拉起后台线程并使std::condition_variable处于wait状态；fork出的子进程继承该condition_variable，但新进程中notify失效，数据进程永久卡死。修复数据通道RingQueue相关处理（fork前确保状态干净），PR#82773 ‘Fix ringqueue’（2025-03-11合入）。
#138	CogVLM2/Qwen-VL的VIT Attention中bmm算子报错	两层根因：bmm注册预期环境变量控制默认关闭，实际管不住注册、默认开启；开启后Attention的bmm weight为4维shape算子又不支持。当前修复删除bmm算子注册、改走aclnn接口（KG核实aclnnBatchMatMul存在），PR#82658（2025-03-08合入），后续按场景限制重新使能。
#142	AllToAllV算子缺block_size属性，多一次D2H拷贝	MoE等场景AllToAllV按块通信（KG核实AllToAllV为HCCL通信算子，comm-libs仓有host实现），原接口缺block_size属性，框架需D2H取发送计数引入额外拷贝。PR#82568为AllToAllV增加block_size属性（2025-03-08合入），免去一次D2H数据拷贝，提升网络性能。
#585	numpy.broadcast_to负数shape输入导致infer常量折叠失败	根因是ops.broadcast_to常量折叠（infer value）函数不支持负数输入：mindspore.numpy.broadcast_to语义允许-1表示广播维度，折叠路径遇负数执行失败致图推导报错。修复补齐折叠函数负数支持并加UT看护，PR#89352（2025-09-15合入）。
#20707	动态图DVM融合算子输入shape含0时core dump	根因是DVM（动态图算子融合）的codegen未考虑shape为0的边界场景，生成非法kernel导致core dump。修复在DVM codegen里判断shape 0场景直接不执行融合，并补充ST用例test_shape_zero看护，PR#90673 ‘fix dvm shape zero core dump’（2025-11-28合入），由DVM特性PR#88264引入。
#20715	Tensor构造接口传入非法参数直接coredump	根因是cpython层TensorPyinit在入参校验失败时异常未被捕获，继续往下执行访问非法状态而崩溃。修复为校验失败时返回-1，交由Python异常机制自动抛出清理，并在PR中添加非法参数用例看护；master分支PR#90609（2025-11-29合入），后续PR#91093（2025-12-11）继续修正。
#20728	源码编译CPU后端包import时报Create device context failed	ldd排查：libmindspore_cpu.so编译成功但_c_expression.so未链接——链接器默认–as-needed裁掉未引用的库，CPU device context符号缺失。修法：ccsrc/CMakeLists.txt包裹-Wl,–no-as-needed mindspore_cpu -Wl,–as-needed强制保留，PR#90556（2025-11-17合入）。
#20896	开aclgraph推理100 step后稳定同步流报错	框架默认每100 step显存碎片整理（eager free全部idle显存），而aclgraph依赖固定内存地址、独立显存永不释放（KG核实），两者冲突致底层越界。修复开启kernel launch capture时关闭碎片整理，PR#89787（2025-10-14合入），自验1000 step不复现。
#20906	profiler非root用户开DISK/OSRT采集卡死，参数被禁用	非root停止perf/iotop等采集子进程需sudo kill，原/usr/bin/msprof_data_collection.sh的set-sudoers未配免密导致收尾卡死，故框架禁用了非root下两参数。修复补齐sudoers白名单并解除限制，PR#89714（2025-09-30合入）。KG核实msprof采集命令文档，OSRT为系统运行时采集项。
#21073	MCore-DS3预训练MTP层放最后pp stage时空指针报错	MF跑DeepSeek3把MTP层设到最后一个pipeline stage命中共享权重bug：MTP层权重与前面stage共享时Receive算子abstract设置错误，Start Training阶段空指针崩溃。修复Receive算子abstract设置，PR#88929（2025-08-29合入），由PR#83875引入；回归mtp_loss正常输出。
#21150	hifloat8转float32数值错误（0.1转换后值不对）	ms.Tensor(0.1, hifloat8)转float32后值错误，属dtype转换路径bug而非格式本身：KG核实HiFloat8是昇腾8位浮点格式（动态尾数编码、NPU ARCH 3510支持，AscendC Cast原生支持hifloat8_t）。修复互转精度，PR#87844（2025-07-26合入）。
#21171	vpp虚拟流水线场景共享参数处理存在bug	vpp（virtual pipeline parallel，交错式流水线）场景下框架对共享参数（同一Parameter被多层引用）的处理存在bug，影响带共享权重的组网训练。修复共享参数处理逻辑，PR#87505 ‘fix_shared_param_bug’（2025-07-17合入）。该单为内部自提跟踪单，issue正文未展开细节，修复依据为官方关联PR（已验证合入）。
#21679	Storage引用计数错误导致显存泄露	Storage（Tensor底层存储）引用计数维护错误，存储对象提前释放或延迟不释放，表现为显存泄露。修复引用计数增减逻辑，PR#85515 ‘fix storage ref count error’（2025-05-24合入）。与#21690同属untyped_storage系列bug，是MindSpore对齐PyTorch Storage API过程中暴露的配套问题。
#21690	untyped_storage()的copy_拷贝越界访问内存	storage_b.copy_(storage_a)时，内部临时拷贝对象的shape和dtype设置错误，导致按错误大小分配/访问，实际大小变大后内存越界。修复拷贝路径上临时对象的shape/dtype构造，PR#88829 ‘fix storage copy_ bug’（2025-08-27合入）。复现：CPU下两个1000元素Tensor的untyped_storage互相copy_即触发。
#21696	aux_loss/mtp_loss未参与计算直接返回初始化值时后端空指针崩溃	网络返回多个loss时后端loss_cnode取到tuple，框架默认其全部参与计算而未判空；当某个loss（如未启用的mtp_loss）只是返回初始化值时该项为nullptr，触发空指针报错。修复为对多loss逐项判空、为空则跳过，master分支PR#88384（2025-08-15合入）、r2.7分支PR#88527（2025-08-19），问题由多loss输出特性（PR#73986）引入。
#29018	macOS跑SSD官方教程，Dataset多进程取数时RuntimeError拉起失败	minddata多进程用消息队列/共享内存传数据，macOS上msgsnd超限返回EINVAL（errno 22）；官方确认macOS沙箱下无法sysctl调大kern.ipc.msgmnb/msgmax，属平台限制非框架bug。解法为调整教程脚本规避，mindspore/docs仓PR#18534（2026-05-09合入）。

mindformers（大模型套件）

DeepSeek/Qwen 类大模型训练与推理套件，权重保存加载与并行策略适配的前线

编号	Issue 问题内容	解答总结
#23	dev 分支第二次编译必现权限 error	根因：首次 build 产生的目录无写权限，第二次编译时无法删除更新 build 目录内文件。修复：build.sh 对编译产物目录添加写权限，重复运行 build.sh 验证通过。修复 PR5886，2025-04-02 合入。引入分析：由 PR5572（2025-03-07 合入）的修改引入，属修复问题合入引入。
#32	混合模式 CP 配置名拼写错误 hybird_cp	根因：配置项拼写错误，hybird_cp 应为 hybrid_cp。修复 PR5817（2025-03-31 合入 r1.5.0）：更名并做兼容——旧名仍能开启混合并行，但打印即将更名的提示，避免配置静默失效。引入自 PR3831（2024-08-30）。KG 佐证：hybrid context parallel 是昇腾生态标准术语，可与 MindSpeed 同名特性交叉印证。
#37	动态 shape 微调 Qwen2.5 报 pad_token_id should be list	根因：动态 shape 场景每个数据列需独立 pad_token_id，要求 list 类型，传 int 报 ValueError。修复：pad_token_id 为 int 时视作所有数据列共用该值填充。PR5761 2025-03-27 合入 dev，附动态 batch 用例与 qwen2.5 拉起自测截图。
#83	deepseek checkrules 校验未计入 mtp_depth 致 pp 切分被误拦	根因：实际层数=mtp_depth+num_layers，check_rule 未计入 mtp_depth，pp<=总层数但>num_layers 即误拦（214 并行、3+1 层）。修复 PR5418（03-20 合入）：层数校验拆入 PretrainModel.check_pipeline_stage 并计入 mtp_depth，8 卡 214 并行验证通过；MTP 为 DS 系标配。
#101	CANN 装非默认目录时 run_check 误报环境错误	根因：run_check 只在默认路径探测 CANN，自定义目录安装时报 Cannot find cann info，误导用户以为环境损坏。修复 PR4773（2025-03-22 合入）优化检测逻辑：CANN 装自定义目录并 source set_env.sh 后可正常取版本。KG 佐证：安装路径下 set_env.sh 是官方推荐加载方式。
#105	DeepSeekV3 230B 万卡权重合并时报 reshape 冲突	根因：PP+优化器并行含共享权重，last stage 多存一份策略冲突的共享参数；save_checkpoint_network 又把 parameter cast 成 Tensor 丢 param_info，保存侧感知不到共享。修复：共享权重打标签过滤，配套 MindSpore PR81488/81626，PR5473/5474 已合入（02-24）。
#112	deepseekv2 推理 FA 关闭时 shape 不一致报错	根因：MLA 优化引入的 pad 逻辑未同步到推理代码，Attention 计算后 value 的 Pad 值未删除，FA 关闭分支 shape 不一致报错。修复：更正推理侧 pad 的 shape，FA 及非 FA 分支用例看护。KG 佐证：MLA 将 KV 投影到低维 latent 空间，value 维度处理与标准 MHA 不同，pad 时序错位即产生 shape 错位。
#164	PyNative 下用 AutoModel 构建网络 mode 被变回静态图	定性非 bug：MindSpore 原生 set_context 初始化不了 MindFormers 的 context；先 ms.set_context(mode=PYNATIVE) 再 AutoModel 构建时，MF 侧 context 未初始化，按默认静态图构建，似被重置。解法：改用 mindformers.set_context 或 build_context 设动态图后再构建。
#181	infer_boost 默认开启致 CPU 后端部分算子计算错误	根因：predict+graph mode 下 infer_boost 自动开启，走异步拷贝输入数据，CPU 后端未实现该接口，输入为无效数据致算子精度错误。修复：MindSpore PR78398 增加 CPU 异步拷贝接口；商定 infer_boost 整网暂不支持 CPU 后端，先保证 Gather 等算子正确，补丁验证输出已符合预期。
#504	deepseek2 128 卡训练下发性能慢	根因：MF 误修改使训练分支也走入绑核逻辑，主线程被绑到单个 CPU core，128 卡下发性能骤降。1.2 日确认由 PR5209 引入，1.6 日修复 PR5244：MS_ALLOC_CONF、CPU_AFFINITY 等环境变量仅在 predict 模式生效。现场验证已解决。KG 佐证：CPU 亲和性绑核需限定作用场景，训练态误绑单核是典型性能陷阱。
#507	llama2-70b awq w4a16 量化解包报错 not enough values	根因：mindformers 新增 qkv、ffn 权重重排特性后，ffn 部分 x shape 变 3 维，golden-stick 量化侧未适配，解包报 not enough values to unpack (expected 3)。修复：golden-stick PR748 适配 x 的 shape，2024-12-31 全量回归通过。跨仓特性联动需同步适配量化工具的典型案例。
#1941	仓库镜像链接存在供应链安全风险	根因：仓库 README 等处存在 docker 镜像下载链接，外部镜像源内容难以充分验证，构成供应链安全风险（PR6260 引入）。修复：删除仓库内全部镜像链接，PR6634(dev)/6638(r1.5.0) 已合入（06-26），配套 docs PR16884/16885 同步清理。开源仓「最小外部依赖」治理示例。
#2359	动态图开 pp2 加载自训权重不改策略续训失败	根因：pp 场景模型按层切分，metadata.json 仅 rank0 保存，model_keys 只含本 stage 局部权重名，其他 stage 权重被误定向到优化器文件，加载即报找不到权重。修复：改用 hyper-parallel get_global_layout 取全局 meta 与 model_keys，PR8429 已合入（06-18），16 卡 deepseek 续训回归通过。
#2407	loss 追踪重构后 deepseekv4 未接接口致部分 loss 缺失	根因：PR8465（2026-06-30 合入）将 MoE/MTP/index loss 追踪重构为模型实例方法并修复 recompute 重复累加问题，deepseekv4 未接入新接口，导致部分 loss 信息缺失。修复 PR8490（2026-07-01 合入 master）：deepseekv4 添加对应接口后可打印完整 loss。重构类改动需盘点全部模型接入点的典型案例。
#2413	dsv4 单卡报 src:meta 与 dst:Ascend 不支持拷贝	根因：MindSpore 版本更新后参数初始化需显式用 mint.empty，否则张量停留在 meta 设备，拷贝时报 src:meta 与 dst:Ascend 设备类型不符。修复 PR8493（2026-07-02 合入 master）：单卡 dsv4 场景补显式 mint.empty 初始化。该报错是新版 MindSpore 下张量未落到真实设备的典型信号。
#2415	哈希路由下 input_ids 超词表大小取值越界	根因：哈希路由 tid2eid 对 flat_ids 取值时默认 input_ids 在 vocab_size 内，未做越界判断，超范围即索引越界。修复 PR8498（2026-07-02 合入 master）：新增 input_ids>vocab_size 拦截校验，把静默越界转为显式报错。KG 佐证：MoE 路由 topk 类算子对输入域有明确约束。
#2416	dsv4 同时开 MTP 和哈希路由被校验拦截	根因：dsv4 部分代码尚未开发时对该场景做了拦截校验；代码开发合入后未做 MTP 场景验证，校验一直未放开，导致训练同时开 MTP+哈希路由仍被误拦。修复 PR8503（2026-07-03 合入 master）：取消 dsv4 下哈希路由不能和 MTP 连用的校验。属于「临时拦截忘了拆」的典型演进残留。KG 佐证：MoE 路由与 MTP 均为 DeepSeek 系核心特性，可共存设计。

mindspore-lite（端侧与推理部署）

模型转换、量化与昇腾后端部署，converter 与 runtime 问题主场

编号	Issue 问题内容	解答总结
#109	examples下demo的build.sh相对层级错，找不到version.txt	根因：mindspore-lite新建独立仓后目录结构改变，examples各demo的build.sh仍按旧仓层级找version.txt致编译失败，另OBS取包地址失效；属建仓PR#1引入。修复：gitee PR#48改build.sh为正确路径，合入后daily包回归，2025-07-17验证demo执行pass。启示：仓迁移后需整体核对样例脚本相对路径。
#128	NPU后端asan包推理报LeakSanitizer内存泄漏	根因：NPU后端只调aclrtSetDevice未配套aclrtResetDevice，Device资源（默认Context/Stream）不释放，asan包报LeakSanitizer。修复：gitee PR#511配套增加aclrtResetDevice，修复后Asan无异常。KG：CANN官方文档明确两接口配对计数语义，归零才真正释放Device资源。
#202	DestroyTensorPtr只delete不置空，悬垂指针复用致内存错误	根因：MSTensor::DestroyTensorPtr仅delete tensor未置空，文档也没说明需手动置空；语音连续推理复用旧指针即读已释放内存，报难定位的内存错误。修复：PR#704在delete后补tensor=nullptr，2026-03-11合入，随2.9.0发布。旧版规避：调用后自行置空再复用。
#217	镜像的ASCEND_CUSTOM_PATH与lite的CANN检查冲突致导入报错	根因：mindspore 2.8.0镜像设ASCEND_CUSTOM_PATH，lite的_check_ascend.py误将其当CANN version路径，与ASCEND_HOME_PATH冲突，导入报ascend_version_file缺失。修复PR#608（2026-02-05合入，随2.9.0发布）。KG FAQ A-0188：CANN定位以ASCEND_HOME_PATH为准。
#220	FireRedASR推理double free，实为导出维度不一致	官方RCA（liuf9）：动态分档+免拷贝3输出中仅t_scores切CPU tensor时segfault；导出的onnx与pipeline的decoder_odim和模型-1维(8667)不一致，t_scores buffer申请偏小，访问越界引发double free。判定非mslite框架问题。规避：保证pipeline维度与模型一致，或免拷贝输出全放device侧（均正常）。
#225	动态分档resize后get_model_outputs的shape错误	现象：昇腾后端动态分档，resize到[3,17]后get_outputs返回[[6,20]]等错误shape且取不到结果。根因：resize后输出tensor的shape元信息未随新档位更新，读到跨档叠加的陈旧shape。修复PR#697（2026-03-13合入，官方03-17确认）。启示：resize后以get_inputs实际shape确认档位生效。
#312	SpaceToBatchND单算子INT8量化通路偶现coredump	现象：CPU后端，SpaceToBatchND单算子INT8量化偶现coredump（master）。根因：算子内核need-paddings标志（控制是否走padding分支）在量化通路配置错误，触发越界访问。修复：PR#880「正确配置need-paddings」2026-05-29合入，MindSpore-Bot关联该PR后关闭。启示：偶现量化coredump优先查标志位/分支配置。
#446	310P多Chunk场景CGDR结果非确定，Cube/Vector缺同步	根因：Matmul后直接DataCopy从L0C搬UB，Cube写L0C与Vector读间缺M_V同步、Vector完成与Cube复用间缺V_M同步，可能读到未写完数据，输出/final_state非确定漂移（Qwen3.5 GQA、T=512）。修复PR#1174补齐同步屏障，2026-08-28合入。KG：SetFlag/WaitFlag(HardEvent)为官方跨管线同步实践。
#449	Qwen3.5-0.8B decode onnx在300I Duo转换失败，README资料有误	根因：资料ND引号误用缺TUNE_BANK_PATH说明；静态KV=2048 decode图触发300I Duo IncreFlashAttention约束(gqa×qlen≤32)；4GB超protobuf 2GB上限。修复PR#1188资料+PR#727重构exporter；09-07官方以lite-boost新包+CANN9.2回证pass。KG证推理系列FP16-only、GQA比≤8。
#472	恶意TFLITE触发Tensor::shape()堆缓冲区溢出读	根因：Tensor::shape()以shape_+shape_size_构造vector，读侧未校验shape_size_≤16；恶意TFLITE经CopyTensor整体memcpy TensorC绕过写侧防护，shape_size_被污染为2^32，常量折叠越界读16GB。修复：PR#1238在读取侧加合法性校验，2026-09-15合入。报告者本人提交并附PoC。

ascend-deployer（续）

部署工具续表：Python 版本约束、新硬件包名正则适配、文档与发布节奏配套

编号	Issue 问题内容	解答总结
#187	alan 场景改 common_info.py 后装驱动失败，Ascend-hdk 驱动同样报错	坑：新型号（alan）软件包名未适配，scripts/pkg_utils.py 的 tags_map/pkg_run_paths 正则匹配不到新包名，导致驱动安装失败；CANN 报错但实际装成功亦同源。官方解法：在 pkg_utils.py 中对应修改正则以适配新包名。启示：为新硬件使用 deployer 时，包名正则适配是必过的坑——安装日志报“包不存在”先核对 pkg_utils 匹配规则。
#194	Python 3.14 下执行 install.sh -h 直接崩溃，帮助信息无法输出	坑：-h 在参数解析前就触发 inventory_file 解析并写 parsed_inventory_file，Python 3.14 的 configparser 写入限制抛 InvalidWriteError（3.11 正常）。根因：超出支持版本且帮助路径有副作用。官方已在 docs/zh/introduction.md 约束 Python 版本（3.6~3.12）；规避即切回受支持版本。
#204	PyPI 在线包不识别 --show-releases，文档教的配套版本查询直接失败	坑：文档先行、发布滞后。官方确认参数已合入主线，但当时 PyPI 最新包 7.3.0 未随包携带 downloader/release_config.json 等配置，安装后参数不识别。解法：等新版或改用源码主线。社区 PR !2220 提议将 release_config.json 声明为 package data 并补回归测试（未合入）。启示：遇到“文档有、包里无”，先比对新能力发布节奏。

组合解读：这 50 条里的共性规律

1. 引用计数与资源配对是本批最大的底层缺陷家族。
CPython 接口多余 Py_INCREF 致 Tensor 显存泄露（mindspore#124）、Storage 引用计数错误（#21679）、untyped_storage 的 copy_ 拷贝越界（#21690）、lite 只 aclrtSetDevice 不 reset 致 asan 报泄漏（lite#128）、DestroyTensorPtr 悬垂指针复用（lite#202）、fork 前 condition_variable 状态不干净致子进程卡死（#130）。加/减、建/拆、set/reset 必须成对出现，C 侧接口尤甚；长稳训练显存缓涨先查配对。

2. 崩溃三来源：边界输入、底层同步、恶意构造。
shape 0 触发 DVM codegen 生成非法 kernel（#20707）、Tensor 非法参数 coredump（#20715）、input_ids 超词表静默越界（mf#2415）、GIL 持有过早与后台线程死锁（#116）、多 loss 输出未逐项判空（#21696）、恶意 TFLITE 污染 shape_size_ 越界读 16GB（lite#472）、量化通路 need-paddings 标志配错（lite#312）。防御位置在入口校验与读取侧校验，不是事后兜底。

3. PP 切分下的权重保存加载，先问「这份元数据是谁的视图」。
last stage 多存一份策略冲突的共享参数（mf#105）、metadata.json 只含 rank0 局部 model_keys 致权重误定向到优化器文件（mf#2359）、MTP 层放最后 stage 命中共享权重空指针（#21073）、张量停留在 meta 设备报 src:meta 拷贝错（mf#2413）。切分场景的保存/加载一律用全局 layout 视口核对，共享权重单独打标处理。

4. DeepSeek 系特性适配链，重构最易漏接入点。
mtp_depth 未计入层数校验误拦 pp 切分（mf#83）、MLA 的 pad 逻辑未同步推理分支（mf#112）、loss 追踪重构后 dsv4 未接新接口（mf#2407）、「临时拦截忘了拆」挡住 MTP+哈希路由（mf#2416）、绑核环境变量误入训练分支致 128 卡下发骤慢（mf#504）。新特性重构要盘点全部模型接入点，临时校验要有拆除清单。

5. 「不是 bug 是契约」的官方定性最省排查时间。
aclgraph 依赖固定地址与每 100 步显存碎片整理冲突（#20896）、infer_boost 的异步拷贝 CPU 后端无实现（mf#181）、ms.set_context 初始化不了 MindFormers 的 context（mf#164）、300I Duo IncreFlashAttention 的 gqa×qlen≤32 约束（lite#449）、CANN 定位认 ASCEND_HOME_PATH 而非 ASCEND_CUSTOM_PATH（lite#217）。机制冲突与用法陷阱先查行为契约，再怀疑代码。

6. 端侧部署先过环境识别与硬件约束关。
onnx 转换撞 protobuf 2GB 上限与推理系列 FP16-only（lite#449）、动态分档 resize 后读到陈旧 shape（lite#225）、免拷贝输出维度不一致引发 double free（lite#220）、CPU 后端包被链接器 --as-needed 裁库（#20728）、profiler 非 root 需 sudoers 免密（#20906）、macOS 消息队列上限属平台限制（#29018）。部署前核三件事：硬件约束、环境变量、平台差异。

7. 算子注册与类型转换路径的语义完备性。
bmm 注册管不住且不支持 4 维 weight（#138）、broadcast_to 常量折叠不支持负数（#585）、hifloat8 转 float32 精度错误（#21150）、CGDR 的 Cube/Vector 间缺同步屏障（lite#446）、AllToAllV 缺 block_size 多一次 D2H（#142）。新 dtype、新格式、新融合路径上线时，转换与折叠的语义覆盖要同步补齐。

排错指引（从这批 issue 提炼）

症状	第一优先动作	本篇相关案例
训练显存缓涨 / asan 泄漏	查引用计数与 set/reset 配对；asan 包复现	ms#124、#21679、lite#128
偶现 coredump	边界输入（shape 0/非法参数/越界）；量化标志位配置	ms#20707、#20715、lite#312、lite#472
动态图卡死	GIL 释放路径；fork 前后台线程状态	ms#116、#130
pp 保存/加载权重错	全局 layout；共享权重过滤；张量落真实设备	mf#105、#2359、#2413
DS 系 loss 缺失/被拦	mtp_depth 计入校验；重构盘点接入点；拆临时拦截	mf#83、#2407、#2416
端侧转换/推理失败	硬件约束与 protobuf 上限；ASCEND_HOME_PATH；维度一致	lite#449、#217、#220
aclgraph 长跑同步报错	capture 期间关闭显存碎片整理	ms#20896
非昇腾环境（CPU/macOS）	链接 --no-as-needed；sudoers 白名单；平台 IPC 限制	ms#20728、#20906、#29018

涉及具体 API 语义与硬件约束的核对，用了昇腾知识图谱（ascend.wiki）的官方文档节点；各条解答中 KG 核实过的部分不再单独标注，评论与 PR 均无依据的信息一律未收录。本篇承接上篇溢出的 ascend-deployer 续表 3 条（#187/#194/#204），至此 Ascend 组织巡礼完结。接入昇腾知识图谱 https://gitcode.com/agent0/kg-tools

系列下一篇：CANN 精选（三）—— 回到 cann 组织其余高价值仓库，继续深挖昇腾生态开源 issue 富矿。