昇腾开源仓Issue分析解答-mindspore精选（三）·主仓与mindformers长尾收官
一句话让Agent变成昇腾专家，昇腾任务轻松搞定。评测入口：请按这个开源仓接入昇腾图谱 https://gitcode.com/agent0/kg-tools
总览
| 仓库 | 定位 | 收录条数 |
|---|---|---|
| mindspore | 昇思深度学习框架主仓，本篇双表收官 22 案（图执行与通信修复链 12 + 接口校验与教程口径 10） | 22 |
| mindformers | MindSpore 大模型套件：DSA 稀疏注意力、辅助 loss 口径、pynative 能力与 dsv4 断点续训四表 28 案 | 28 |
mindspore（框架主仓·图执行与通信修复链）
昇思主仓·长尾收官：图执行回归、算子语义修复与集群通信三线，含引入+修复双锚点与 15 MR 回退链
| 编号 | Issue 问题内容 | 解答总结 |
|---|---|---|
| #20673 | kv_scale_cache量化KV cache缩放能力任务单 | kvscale能力经PR 85440（ljs-ms-kvscale-testok，2025-06-04合入）测试通过，随迭代PR 86633 infer_ops iter4（正文首条即ms-kvscale-testok，含mla preprocess等）2025-07-09合入，issue次日在2025-07-10关闭，时间窗与正文语义双吻合。86633的Fixes指向gitee号ICGUBZ。 |
| #21143 | mindspore不支持全冻结网络的PP并行（编译卡死） | 蒸馏场景teacher全冻结+lazy_inline开启PP并行编译卡死，执行序停在receive begin。SSR活动流关联双PR：88049 freeze grad（2025-08-04合入）与88260 fix_freeze_bug（2025-08-12合入），两PR均Fixes gitee号ICR1P3，支持全冻结网络PP并行，issue一个月后关闭。 |
| #21705 | 精度故障不重启快恢偶现卡死 | PR 84439 support spike fast recovery（2025-04-19合入）正文明确为精度故障不重启恢复方案，与issue标题语义直配，issue于3天后2025-04-22关闭。Fixes指向内部需求编号AR.SR.IR20250325004495。 |
| #21803 | DVM MatMul融合算子dry run时core dump | 根因：dry run跳过DVM编译，MatMul kernel部分变量未初始化，析构时访问未初始化指针导致core dump。修复：析构函数对指针判空，并补充run_matmul ST用例。PR 80369合入，merged_at与issue关闭秒级一致，PR正文根因描述与评论一致。 |
| #21810 | xlogy tensor接口语义不清晰（入参命名） | xlogy(y)与参考接口other入参是同一参数，需补说明。PR 80293修复xlogy doc bug，PR正文所写问题与issue标题逐字相同，merged_at 2025-01-09T11:05:50与issue关闭时间秒级一致；前置PR 80179（fix xlogy docs，2025-01-03）同主题。Fixes gitee号IBG73N。 |
| #21812 | GMM 310P nz weight自动转换逻辑被重构误删 | 双锚点还原：nz weight自动转换由PR 74073（GroupedMatmul aclnn支持weight输入为nz，2024-08-23合入）引入，经PR 74745重构（2024-09-06合入）被误删。修复PR 80259正文写明加回被删除的GMM逻辑，merged_at与issue关闭秒级一致。Fixes gitee号IBF6PM。 |
| #28905 | MaskedFill反向在NaN/Inf场景与PyTorch结果不一致 | MindSpore反向用乘法掩码，dout含NaN/Inf时0*NaN仍为NaN，被掩码位置梯度不为0；PyTorch用masked_select分支规避。PR 91648重写MaskedFill反向实现消除不一致（标题Resolve the inconsistency...），SSR活动流关联，2026-01-28合入，issue次日关闭。 |
| #28907 | 复用外部hcom时会重复销毁通信域 | AscendCommunicationGroup::Finalize无条件调HcclCommDestroy，复用经group options传入的外部hcom时会销毁不属于自己的通信器。PR 91647在hcom由options传入时跳过HcclCommDestroy，正文与issue逐字对应，merged与关闭差99秒。KG：该API语义见hcomm参考。 |
| #28944 | 图编译infer value输入device tensor未同步到CPU | 图编译infer value流程需要CPU侧输入以完成host计算并常量折叠，但流程未在infer value前校验输入device tensor是否同步到host。PR 91764 fix infer value getting device tensor（正文与issue逐字对应）2026-02-27合入，20分钟后issue关闭；后续91981同名重做合入、92098回退尝试未合。 |
| #28991 | A3环境bind_numa+ASCEND_RT_VISIBLE_DEVICES时无法绑内存 | A3环境无npu与numa亲和关系，取不到亲和信息时绑定策略退化为均分，配合ASCEND_RT_VISIBLE_DEVICES指定后绑不上内存。PR 91845修复A3场景绑定，1.5小时后issue关闭；feature引入为PR 91635。KG：该环境变量语义见runtime设备管理文档。 |
| #28992 | 支持mccl异步初始化（4k节点启动慢） | 4k节点初始化10分钟，初步分析4分钟耗在mccl初始化SynchronizeAddresses收集节点信息（随集群规模线性变慢）。落地链：PR 92054合入→PR 92174回退：异步mccl初始化→PR 92456 support mccl async重做合入（2026-04-24），SSR活动流共关联15个MR，issue 2026-05-19关闭。 |
| #28999 | 动态图无图融合device地址踩踏导致精度问题 | LazyFusionKernelAscend::Flush里device_address是for循环内局部weak_ptr，当前循环结束即释放，下轮可能复用同一地址或与Codegen的workspace冲突，多输出/带workspace融合算子触发地址踩踏。PR 91865修复device address collision，SSR活动流关联，2026-02-12合入。 |
mindspore（框架主仓·接口校验与教程口径）
主仓·长尾收官二：接口校验缺失、初始化语义演进与「教程默认 Ascend 平台」复现口径（含上篇拆入 #544/#248/#29041）
| 编号 | Issue 问题内容 | 解答总结 |
|---|---|---|
| #248 | gelu按位置参数传approximate报TypeError | 根因：PR 81218接口变更对齐torch2.1，approximate改为keyword-only参数；特性直接合master转测且转测邮件发得晚，测试未感知未适配用例。处理：已发接口变更邮件，测试仓用例改关键字传参适配，mindspore仓无需改码。 |
| #544 | mint.narrow pynative模式start/length越界未抛ValueError | 根因：pynative执行路径缺少start和length参数校验（graph模式已有），越界输入不报错。修复：开发补上校验后用例恢复预期报错（length should be in 0, N），master commit 2ead7024回归通过；评论称修复在某PR中但未附编号。 |
| #28939 | 910A上MS 2.7.2测试失败、2.8.0 import段错误(910B正常) | 提问者自定位根因并解决：问题环境的CANN 8.5等安装包取自公司CMC内部渠道，非官方最终发布包；910A环境改用官方最新CANN 8.5包重新安装部署后，MindSpore 2.8.0 NPU能力测试恢复正常。教训：同版本号下内部渠道包与官方发布包行为可能不同，NPU工具链务必用官方发布包。 |
| #28969 | RNN教程加载预训练词向量，跑测结果与文档不一致 | 官方口径回复（li-tingyu 2026-04-25）：本教程的实验均在Ascend设备上执行，由于平台差异，在CPU上复现时结果可能有所不同。非文档错误，属教程默认硬件平台与用户复现平台不一致导致的预期差异。 |
| #29001 | 教程用init初始化器构造张量，实测打印uninitialized | 官方确认（li-tingyu 2026-04-25）：接口在此版本有更新，修正早期'隐式初始化'的不严谨设计------init构造的张量打印属预期，教程已更新。KG佐证：同生态PyPTO FAQ明确tensor声明不含初始化行为、未初始化Tensor不申请内存、须先写后读，设计哲学一致。 |
| #29002 | WeightedRandomSampler示例含%matplotlib inline致语法错误 | 根因：示例残留Jupyter魔术命令%matplotlib inline，复制到.py脚本执行即SyntaxError。修复：mindspore/docs#18291（master）与#18299（r2.8.0）删除该行，标题'remove matplotlib inline'，均2026-02-28合入（pulls API核实）。官方另指出用户复制代码与页面显示不一致。 |
| #29007 | SSD教程import cv2报libxcb.so.1缺失错误 | 官方先建议装libxcb依赖，提问者实测仍报错；改用opencv-python-headless==4.11.0.86后解决。官方（shenwei41 2026-03-30）确认原理：headless版不依赖libxcb等图形库，且SSD脚本未用GUI接口，可安全替代opencv-python；也可检查opencv_python.libs下是否有libxcb相关so。 |
| #29033 | WeightedRandomSampler页面显示无效字符串 | 根因与#29002同源：数据加载与采样页面残留%matplotlib inline无效字符串（同一页面既致显示异常又致复制的代码语法报错）。修复为同一组PR：mindspore/docs#18299（r2.8.0）与#18291（master），标题'remove matplotlib inline'，均2026-02-28合入。官方留言'以上问题已经修复，pr已合入'。 |
| #29041 | RandomSampler文档示例结果无法印证有放回/无放回采样的说明 | 官方解答：无seed时采样结果每次不同属预期行为，需固定结果可ds.config.set_seed(1000)。文档缺陷同步修正：原示例结果1 4 5 8 7看不出重复采样，改为类似1 4 5 8 1以体现有放回时同一数据可被多次抽取；mindspore/docs仓PR 18412/18413正文Fixes显式引用本issue，2026-03-31合并。 |
| #29054 | 图模式非控制流场景教程称支持，Windows执行报错 | 官方说明（shuqian0 2026-03-06）：该用例需运行在Ascend环境，Windows执行报错属平台限制非文档错误；教程已补充平台限制说明。修复PR：mindspore/docs#18261（master）与#18262（r2.8），标题为给view in-place用例添加Ascend平台限制，均2026-02-27合入。另有人追加同类报错，未见后续。 |
mindformers（大模型套件·DSA 稀疏注意力）
DeepSeek 系 DSA（稀疏注意力）落地六案：排布、重排插入、显存与 indexer rope
| 编号 | Issue 问题内容 | 解答总结 |
|---|---|---|
| #2214 | DSA已知问题：BSND+cp多余通信显存涨；dense+pp报错卡死 | 跟踪型自提单列两项缺陷：①BSND排布融合算子未适配cp→多余通信+显存上涨；②dense阶段开pp报错/卡死。②由PR8092修复（03-17合入：支持dense阶段pp+规避equal算子bsnd问题）；①由PR8211 dsa算子混合tp+cp并行解决（04-28合入）。两PR均显式Fixes主跟踪单#2207而非本单，间接锚点。 |
| #2230 | DSA与Megatron精度未对齐：首loss对齐、首norm即分叉 | 官方确认DSA实现流程与Megatron不完全一致：仅能保证前向精度一致，反向无法保证，需待CANN loss融合算子接入后重新比对。融合算子后经PR8181接入（2026-04-15合入，挂DSA主跟踪单#2207），同步修复dense阶段误用SFA而非FA算子问题。属已知差异说明型关单，非当日代码修复。 |
| #2234 | 大规模并行时框架自动插入复杂重排致DSA运行失败 | 根因：MindSpore在大规模并行时自动插入重排节点，且跨子图直接reshape触发错误重排（TND排布一阶段）。修复：改写可能触发重排的节点消除插入源，用dp2tp4pp2cp8 dryrun存图验证重排消除。PR8196正文显式Fixes #2234，2026-04-22合入。 |
| #2252 | DSA二阶段128k长序列峰值显存比不开DSA高7倍 | 根因：权重吸收逻辑导致反向计算显存占用过高。修复：PR8229优化权重吸收逻辑降低反向显存，正文显式Fixes #2252，2026-04-30合入（提单56分钟后）；与后续PyNative DSA长序列显存优化线衔接。 |
| #2290 | DSA一阶段TND排布时attention被迫退回BSND排布规避 | 根因：FA算子输出的softmax_max/softmax_sum排布不符合TND一阶段需要，此前用BSND规避。修复：PR8288新增softmax_out排布转换，一阶段直接用FA的TND排布；8层纯pp网络新旧实现loss对齐，并泛化验证dp=tp=cp=pp=2。Fixes显式，2026-05-27合入。 |
| #2302 | DSAIndexer中rotary位置编码计算不正确 | PR8317『interleave fix』修改indexer中的rope配置（interleaved rotary修正），正文Fixes #2302；2026-06-26T11:09:44合入与关单时间秒级一致（Fixes自动关单）。 |
mindformers（大模型套件·辅助 loss 缩放与 MoE 统计口径）
精度对齐长尾高发区：aux/MTP loss 反向缩放、expert_bias 统计与 grad_norm 打印口径
| 编号 | Issue 问题内容 | 解答总结 |
|---|---|---|
| #2257 | 开启FSDP+EP组合精度与单卡训练不对齐 | PR8242『fix loss sense for distributed』正文显式关联#2257：分布式下loss sense（辅助loss反向缩放）设置错误，致FSDP+EP与单卡不对齐；05-08合入、次日关单。与后续#2356/#2380的loss sense问题族同源。 |
| #2329 | expert_bias计算静态图未做零均值归一化与动态图不一致 | 根因：动态图expert_bias计算做了零均值归一化、静态图没做，expert_bias_delta及更新结果不一致。修复：PR8363删除动态图零均值归一化统一口径，重打expert_bias_delta验证一致；06-08T21:42:26合入与关单秒级一致。 |
| #2338 | 动态图local/device grad_norm打印的是通信后的值 | PR8385『print local_norm』正文显式关联#2338：调整local/device grad_norm打印口径为通信前的本地值；06-18T18:08:59合入与关单秒级一致。 |
| #2349 | 并行下tokens_per_expert_by_layer未all_reduce致精度不齐 | 根因：开启并行时tokens_per_expert_by_layer未做all_reduce，各dp域统计不一致→更新后expert_bias分叉、精度无法对齐。PR8400『动态图expert_bias all_reduce』补齐规约，正文显式关联#2349；06-13T19:26:00合入与关单秒级一致。 |
| #2380 | 单卡梯度累积下MTP/aux loss梯度被放大与不累积不一致 | PR8436显式关联#2380：主CE loss已做累积归一，但MoE aux/mtp/index辅助loss的AutoScaler backward scale原仅在SPMD路径设置，单卡保持1.0未折叠1/累积步数，辅助梯度放大N倍。修复：Trainer初始化无条件统一设置缩放。关单评论验证：修复后累积vs不累积grad_norm差2.8e-03(bf16噪声级)。 |
| #2398 | tp切分下moe模型indexer loss对比基线存在跳变 | 根因（评论）：tp切分下indexer与moe叠加造成累积数值漂移，最终loss跳变。PR 8479移除indexer_loss的tp切分（关闭csa部分tp以规避），对齐后曲线复平。Fixes显式标注。 |
mindformers（大模型套件·pynative 动态图能力）
pynative 动态图能力补齐与性能：梯度裁剪、延迟初始化、CPU 侧切片与数据广播
| 编号 | Issue 问题内容 | 解答总结 |
|---|---|---|
| #2275 | 动态图训练不支持梯度裁剪 | 能力缺口而非回归：pynative Trainer缺clip_grad路径。PR 8260实现动态图梯度裁剪防梯度爆炸，并将需_distribute_param的参数统一放入plan再分发；fsdp+tp+ep多组合与单卡精度对齐。合入与关单同秒。 |
| #2278 | 延迟初始化仍慢，改用ms接口穿刺继续提速 | PR 8205首版延迟初始化（5层模型构建51s→24s）；PR 8271改用ms接口穿刺：100层193s→1.5s、500层仅7.5s，续训精度fsdp/tp/ep各组合对齐。Fixes显式标注，合入与关单同秒。 |
| #2330 | pynative Dropout在drop_prob=0.0训练态仍下发dropout算子 | 语义缺陷：概率为0即语义关闭，训练态也应直返输入（训练图库transformer dropout已有短路先例）。PR 8367在construct加短路：training=False或drop_prob=0.0直接返回，仅真启用时调mint F.dropout，并补回归用例。合入与关单同秒。 |
| #2332 | 开dp shard后dp大小与dp_shard相同，应与dp一致 | 并行维度语义错误。PR 8372修正开dp后数据dp与dp大小一致；dp shard2 replicate2 gbs4与单卡gbs4精度对齐验证。KG佐证：FSDP按分片度切分参数/梯度/优化器状态，dp_shard与dp_replicate分工不同。 |
| #2334 | 动态图加载权重slice时h2d影响性能内存，易卡死 | 根因：转换策略slice前先把权重h2d拷到device再切片返回。PR 8375用with DeviceCtx("CPU")上下文直接在CPU上切片不做h2d，节约内存与时间：动态图fsdp2tp2ep2转配提速约20%、静态图dp2tp4转tp8提速约33%。Fixes显式标注。 |
| #2448 | dsv4融合算子分支(csa_fix)开重计算后显存持续增长至OOM | 重计算本为省显存却反向泄露：csa融合算子分支重计算过程部分中间张量未被正确释放。PR 8571修复释放逻辑，附修复前后显存曲线对比；合入与关单同秒。KG佐证激活重计算属训练显存优化四层手段之一。 |
| #2468 | MaxLogitsMonitor隔步打印崩溃且无法独立关闭日志 | 根因：非打印步把Trainer的模型列表传给单模型reset接口报AttributeError；日志输出与每步清零tracking状态耦合。PR 8602新增enable_logging、reset每步执行与日志解耦，step_interval只控频率，跳过打印不读Tensor避免额外D2H同步；30个UT通过。 |
| #2524 | 开use_distribute_dataset后所有rank冗余初始化数据与index map | PR 8704/8738（master与r2.1.0-beta1双分支）：每个TP×CP数据域仅src rank真正读取构造数据集，其余rank运行时接收广播batch；ordered_index_dataloader仅rank0生成并保存index map。8卡TP2dp4训练50步结果与改前一致。 |
mindformers（大模型套件·dsv4 与断点续训）
DeepSeek V4 适配与断点续训：hash router 校验、优化器状态前置校验与选择性重载
| 编号 | Issue 问题内容 | 解答总结 |
|---|---|---|
| #2292 | MLA q_lora_rank=None时开tensor_parallel报模块不存在 | 根因：MLASelfAttention仅在q_lora_rank非None时创建linear_qb/q_layernorm子模块，但parallelize.py的TP切分计划无条件收录两者，切分时Module not found报错。PR8299改为按q_lora_rank条件加入TP plan；05-26T20:49:53合入与关单秒级一致。 |
| #2335 | 静态图开pp(>2)时加载权重失败 | 评论二分定位到commit 25408a34（动态图权重加载保存PR8191）。根因：静态图取全局meta信息应按各卡rank_id取对应layout，动态图适配时误用0卡layout。PR8384改为按rank取layout，ds3 dp2tp2pp2续训精度对齐。 |
| #2411 | dsv4单卡训练报错：不支持meta到Ascend的copy | 同报错三连单#2411/#2412/#2414，正主#2413根因：版本更新后参数初始化需显式mint.empty，否则设备类型不符报此错；PR8493改显式初始化并移除注释中Megatron信息，合入当日#2413根因评论后13秒关单，三连单7/1批量关闭。 |
| #2442 | hc_sinkhorn_iters:0配置被前端校验拦截 | PR8550去除mhc_sinkhorn_iterations==0限制：该拦截未与Megatron-LM对齐。DsV4的HC（Head Compression）机制用Sinkhorn混合把hidden state展开到B,S,Hc,D，迭代数0是合法配置；解除后正常拉起训练。合入6分钟后关单。 |
| #2459 | 断点续训缺optimizer文件时报错不明确，HF权重续训无前置校验 | PR8588新增has_optimizer_ckpt检测opt-.safetensors，并在Trainer加载前校验：HF checkpoint+no_load_optim=False直接明确报错不支持；MS checkpoint缺opt文件提前报错并提示设no_load_optim=True或检查文件。issue正文附修复提交e46a1ac25。 |
| #2460 | hash router不能在pp下使用的校验需去除 | 动态图pp代码已合入，该拦截过时。PR8590去除transformersconfig中hash router不能在pp下使用的校验，hash router+pp可正常拉起。背景：DsV4前num_hash_layers层用token-id哈希路由替代top-k softmax路由。 |
| #2475 | hash router的tid2eid在独立FSDP封装下形状不匹配 | 引入PR8581为FP32 router加独立FSDP子包装，绕过父层policy对tid2eidvocab,topk查表的复制约束，8卡切分后延迟初始化写回全表触发(16384,4)!=(131072,4)断言。PR8619删除该子包装，参数回归父layer统一管理，性能波动+0.41%内。 |
| #2490 | 断点续训因冻结参数缺优化器参数致二阶段loss突变 | mla→dsa一阶段→dsa二阶段续训时新解冻参数无优化器状态，主权重被全量重载覆盖已训练状态。PR8623：AdamW/Muon保存fp32主权重sum()校验和快照，reload_main_params_from_model仅对快照未变参数选择性重载，其余保留检查点优化器状态；回合PR8676入r2.1.0-beta1。 |
组合解读：这 50 条里的共性规律
1. 主仓图执行与算子修复七案：dry run 析构、常量折叠同步与融合地址踩踏。
本批主仓技术长尾以「执行路径的隐藏状态」为主：跳过的编译、未同步的输入、循环内早释的地址，都在特定路径才显形。
- mindspore#21803 DVM MatMul 融合算子 dry run core dump：跳过编译致 kernel 变量未初始化、析构访问野指针------PR 80369 析构判空+补 ST（秒级铁证）
- mindspore#28944 图编译 infer value 需 CPU 侧输入做常量折叠，device tensor 未同步 host 就进 host 计算------PR 91764 前置校验同步（合入 20 分钟后关单，后续 91981 重做/92098 回退链）
- mindspore#28999 动态图 LazyFusion 的 device_address 是循环内局部 weak_ptr，当轮释放后地址复用/与 workspace 冲突------多输出融合算子触发精度问题，PR 91865 修地址踩踏
- mindspore#21812 GMM 310P nz weight 自动转换被重构误删：引入 PR 74073→误删 PR 74745→修复 PR 80259 三锚点还原全链（秒级铁证）
- mindspore#28905 MaskedFill 反向用乘法掩码，dout 含 NaN/Inf 时 0*NaN 仍为 NaN、被掩码位梯度非 0------PR 91648 重写反向对齐 PyTorch 的 masked_select 语义
- mindspore#21810 xlogy 入参命名与参考接口 other 关系不清：PR 80293 补文档（正文与标题逐字、秒级），前置 80179 同主题
- mindspore#20673 kv_scale_cache 量化 KV cache 缩放能力：PR 85440 测试通过后随 infer_ops iter4（PR 86633）迭代合入，时间窗+正文语义双吻合
2. 通信域、绑核与训练恢复五案：谁创建谁销毁、异步初始化与快恢。
集群规模上去后，通信域生命周期与初始化耗时分摊成为主矛盾；五案的修复思路都是厘清归属------谁创建谁销毁、初始化按规模异步化、绑定按拓扑找亲和。
- mindspore#28907 复用外部 hcom 时 AscendCommunicationGroup::Finalize 无条件 HcclCommDestroy，销毁了不属于自己的通信器------options 传入即跳过（PR 91647，合入与关单差 99 秒）
- mindspore#28992 4k 节点 mccl 初始化 10 分钟（SynchronizeAddresses 随规模线性变慢）：92054 合入→92174 回退→92456 重做合入，SSR 活动流共关联 15 个 MR 的完整落地链
- mindspore#28991 A3 无 npu-numa 亲和关系时绑定策略退化为均分，叠加 ASCEND_RT_VISIBLE_DEVICES 后绑不上内存------PR 91845 修 A3 场景（KG：该环境变量语义见 runtime 设备管理文档）
- mindspore#21143 蒸馏 teacher 全冻结+lazy_inline 开 PP 并行编译卡死在 receive begin------PR 88049 freeze grad+88260 fix_freeze_bug 双 PR 均挂同一 gitee 单 ICR1P3
- mindspore#21705 精度故障不重启快恢偶现卡死：PR 84439 support spike fast recovery 正文与标题语义直配（Fixes 内部需求号），3 天后关单
3. 接口语义与校验三案：越界静默、keyword-only 与初始化声明。
接口演进期的三类「行为变化不是 bug」：校验补齐让旧用例开始报错、参数变 keyword-only、构造器不再隐式初始化。
- mindspore#544 mint.narrow pynative 缺 start/length 越界校验（graph 模式已有）------开发补校验后用例恢复预期报错（上篇拆入）
- mindspore#248 gelu approximate 改 keyword-only 对齐 torch2.1（引入 PR 81218）：特性直合 master 且转测邮件发晚，测试仓未感知------用例适配（上篇拆入）
- mindspore#29001 init 构造张量打印 uninitialized 属预期：修正早期「隐式初始化」不严谨设计；KG 佐证同生态 PyPTO FAQ 同口径（声明不含初始化行为、未初始化不申请内存、先写后读）
4. 教程复现口径与环境七坑：魔术命令残留、平台差异与渠道包。
教程类 issue 的共同答案是「先核平台与渠道，再怀疑代码」；两条同源 issue 共用一组修复 PR 是本组特色。
- mindspore#29002 WeightedRandomSampler 示例残留 Jupyter 魔术命令 %matplotlib inline，复制进 .py 即 SyntaxError------docs#18291（master）/#18299（r2.8.0）删除该行，双分支同日合入
- mindspore#29033 与上条同源：同一页面的无效字符串既致显示异常又致代码报错------同一组 PR 修复，「一处残留两个 issue」的样本
- mindspore#29054 图模式非控制流用例 Windows 执行报错属平台限制------docs#18261/#18262 补 Ascend 平台限制说明（2026-02-27 合入）
- mindspore#28969 RNN 词向量结果与文档不一致：官方口径「教程实验均在 Ascend 执行，CPU 复现结果可能不同」------与 #28982/#29019/#29024/#29073 同一批口径类关单，零代码修改
- mindspore#29007 SSD 教程 import cv2 报 libxcb.so.1 缺失：headless 版 opencv 不依赖图形库且脚本未用 GUI 接口，opencv-python-headless==4.11.0.86 可安全替代（官方确认原理）
- mindspore#28939 910A 段错误自答闭环：问题环境 CANN 8.5 取自公司 CMC 内部渠道非官方发布包------同版本号下渠道包行为可能不同，NPU 工具链务必用官方发布包
- mindspore#29041 RandomSampler 文档示例结果无法印证有放回/无放回：无 seed 每次不同属预期，ds.config.set_seed(1000) 固定------docs PR 18412/18413 显式 Fixes（上篇拆入）
5. DSA 稀疏注意力六案：排布、自动重排与显存三线。
DeepSeek 系 DSA 落地的问题集中在「张量排布协商」与「框架自动插入的重排节点」两侧，跟踪单+子 PR 是其常见组织形态。
- mf#2214 DSA 已知问题伞单：BSND+cp 多余通信显存涨（PR 8211 混合 tp+cp 解决）、dense+pp 报错卡死（PR 8092 支持 dense 阶段 pp）------两个子问题各配一 PR，均挂主跟踪单 #2207
- mf#2230 DSA 与 Megatron 首 loss 对齐、首 norm 分叉：官方确认前向一致反向不保证，待 CANN loss 融合算子------后经 PR 8181 接入并顺修 dense 阶段误用 SFA
- mf#2234 大规模并行框架自动插入复杂重排、跨子图 reshape 触发错误重排致 DSA 失败------改写重排触发节点消除插入源，dp2tp4pp2cp8 dryrun 存图验证（PR 8196 Fixes 显式）
- mf#2290 FA 算子 softmax_max/sum 排布不符 TND 一阶段需要、此前退回 BSND 规避------PR 8288 新增 softmax_out 排布转换，8 层纯 pp loss 对齐（Fixes 显式）
- mf#2252 DSA 二阶段 128k 长序列峰值显存高 7 倍：权重吸收逻辑反向显存过高------PR 8229 优化（提单 56 分钟后合入，Fixes 显式）
- mf#2302 DSAIndexer rotary 位置编码计算不正确：interleaved rotary 修正（PR 8317，合入与关单秒级一致=Fixes 自动关单）
6. 辅助 loss 缩放与 MoE 统计口径六案：缩放只在并行路径设置。
「单卡与多卡精度分叉」在本批的系统性根因：AutoScaler 反向缩放、零均值归一化、all_reduce 规约都只在部分路径生效。
- mf#2257 FSDP+EP 精度与单卡不对齐：分布式下 loss sense（辅助 loss 反向缩放）设置错误（PR 8242）------与后续缩放族同源
- mf#2380 单卡梯度累积下 MTP/aux loss 梯度放大 N 倍：AutoScaler scale 仅 SPMD 路径设置、单卡保持 1.0 未折叠 1/累积步数------Trainer 初始化无条件统一设置（PR 8436；注意其前身 PR 8432 closed 未合并）；关单评论附累积/不累积 grad_norm 验证表
- mf#2329 expert_bias 动态图做零均值归一化、静态图没做------删归一化统一口径，重打 expert_bias_delta 验证一致（秒级关单）
- mf#2349 并行下 tokens_per_expert_by_layer 未 all_reduce，各 dp 域统计不一致致 expert_bias 分叉------补规约（秒级关单）
- mf#2338 动态图 local/device grad_norm 打印的是通信后的值------改打印通信前本地值（秒级关单）
- mf#2398 tp 切分下 indexer 与 moe 叠加累积数值漂移致 loss 跳变------移除 indexer_loss 的 tp 切分规避，曲线复平（PR 8479 Fixes 显式）
7. pynative 动态图能力八案：能力补齐与性能两线。
动态图线的问题一半是「能力还没有」（裁剪、profile、数据集），一半是「多做了无用功」（h2d 拷贝、冗余初始化、不短路）。
- mf#2275 动态图训练不支持梯度裁剪（能力缺口非回归）------PR 8260 实现裁剪+distribute_param_plan 统一分发，多组合与单卡对齐（秒级关单）
- mf#2278 延迟初始化仍慢：ms 接口穿刺把 100 层构建 193s→1.5s、500 层仅 7.5s（PR 8271；前序 8205 首版 5 层 51s→24s）
- mf#2330 pynative Dropout drop_prob=0.0 训练态仍下发算子------construct 加短路直返输入+回归用例（秒级关单）
- mf#2332 开 dp shard 后 dp 大小与 dp_shard 相同（语义错）------PR 8372 修正，shard2×replicate2 与单卡精度对齐（KG 佐证 FSDP 分片/复制分工）
- mf#2334 动态图加载权重 slice 前先 h2d 拷到 device------DeviceCtx("CPU") 直接 CPU 切片：动态图转配提速 20%、静态图 33%（KG 佐证 h2d 拷贝开销机制）
- mf#2448 dsv4 csa_fix 分支开重计算显存反泄露至 OOM：融合算子重计算中间张量未正确释放------修复附前后显存曲线（KG 佐证重计算为显存优化四层手段之一）
- mf#2468 MaxLogitsMonitor 隔步崩溃+日志不能独立关------enable_logging 解耦、跳过打印不读 Tensor 避免额外 D2H 同步，30 UT 通过
- mf#2524 use_distribute_dataset 所有 rank 冗余初始化数据与 index map------仅 src rank 读取+rank0-only index map（master/r2.1.0-beta1 双分支同秒关单）
8. dsv4 适配、断点续训与切分八案：校验口径与优化器状态。
dsv4 带来一批「校验没对齐 Megatron/已过时」的拦截；断点续训的坑集中在优化器状态的存在性与新旧参数的边界。
- mf#2411 dsv4 单卡报不支持 meta→Ascend copy：版本更新后参数初始化需显式 mint.empty（正主 #2413 根因；同报错三连单为重复单，PR 8493 合入前一日人工批量关闭------非 Fixes 关单）
- mf#2442 hc_sinkhorn_iters:0 被前端校验拦截：HC（Head Compression）用 Sinkhorn 混合展开 hidden state，迭代数 0 合法------解除未对齐 Megatron 的限制（PR 8550，KG 佐证 msmodeling DsV4 适配设计）
- mf#2460 hash router 不能配 pp 的校验已过时（动态图 pp 已合入）------PR 8590 去除拦截；背景：DsV4 前 num_hash_layers 层用 token-id 哈希路由（KG 同上）
- mf#2475 tid2eid 被独立 FSDP 子包装误切分（引入 PR 8581→修复 PR 8619 双锚点，秒级关单）------注意方案漂移：issue 提议 replicate_params 特判，实际合入是删除整个 FP32 子包装（特判会漏 ga_steps 等状态）
- mf#2335 静态图 pp>2 加载权重失败：动态图适配时误用 0 卡 layout------按各卡 rank_id 取对应 layout（PR 8384，评论二分定位引入 commit，秒级关单）
- mf#2459 断点续训缺 optimizer 文件报错不明确------has_optimizer_ckpt 前置校验：HF 权重+no_load_optim=False 明确报不支持、MS 缺 opt 文件提示设 no_load_optim=True（KG 印证跨框架契约：no-load-optim 跳过优化器状态无法真正续训）
- mf#2490 冻结参数缺优化器状态致续训二阶段 loss 突变：主权重被全量重载覆盖已训练状态------fp32 主权重 sum() 校验和快照+选择性重载（回合 PR 8676 入 r2.1.0-beta1）
- mf#2292 MLA q_lora_rank=None 时 TP 切分计划无条件收录不存在的子模块------按条件加入 plan（秒级关单）
排错指引（从这批 issue 提炼）
| 症状 | 第一优先动作 | 本篇相关案例 |
|---|---|---|
| dry run core dump（融合算子） | 核跳过编译路径的未初始化变量与析构判空 | mindspore#21803 |
| 图编译 infer value 报 device tensor | 先同步 host 再做常量折叠 | mindspore#28944 |
| 融合算子多输出精度错（动态图） | 核 LazyFusion 循环内地址生命周期 | mindspore#28999 |
| 掩码位反向梯度非 0（输入含 NaN） | 乘法掩码 0*NaN 陷阱，核掩码实现 | mindspore#28905 |
| 310P GMM nz weight 报错 | 重构误删自动转换，回溯引入+误删 PR | mindspore#21812 |
| 复用外部 hcom 后通信域异常 | 谁创建谁销毁，options 传入跳过 destroy | mindspore#28907 |
| 大集群初始化慢（分钟级） | mccl 异步初始化，核 SynchronizeAddresses 耗时 | mindspore#28992 |
| A3+VISIBLE_DEVICES 绑不上内存 | numa 亲和退化均分，核绑定策略 | mindspore#28991 |
| 全冻结网络开 PP 编译卡死 | freeze grad 支持链 | mindspore#21143 |
| pynative 越界输入不报错 | narrow 类校验缺失，补 start/length 校验 | mindspore#544 |
| gelu 位置参数 TypeError | approximate 已改 keyword-only | mindspore#248 |
| init 打印 uninitialized | 预期设计：先写后读 | mindspore#29001 |
| 教程代码复制即语法错误 | 核 Jupyter 魔术命令残留 | mindspore#29002、#29033 |
| CPU/Windows 复现教程结果不符 | 教程默认 Ascend 平台口径 | mindspore#28969、#29054 |
| import cv2 报 libxcb 缺失 | 换 opencv-python-headless | mindspore#29007 |
| 同版本 CANN 行为异常 | 核安装渠道，用官方发布包 | mindspore#28939 |
| DSA 大并行报重排错误 | 消除框架自动插入的重排源 | mf#2234 |
| DSA 二阶段长序列显存暴涨 | 权重吸收逻辑优化 | mf#2252 |
| 单卡与并行精度分叉 | 先查 aux/MTP loss 反向缩放设置 | mf#2380、mf#2257 |
| expert_bias 动静图不一致 | 零均值归一化口径统一 | mf#2329 |
| 并行下 expert 统计不齐 | tokens_per_expert 补 all_reduce | mf#2349 |
| indexer+moe loss 跳变 | 去 indexer_loss 的 tp 切分 | mf#2398 |
| 动态图模型构建慢 | ms 接口穿刺延迟初始化 | mf#2278 |
| 权重转配卡慢/内存高 | CPU 侧切片避免 h2d | mf#2334 |
| 开重计算显存反涨 | 融合算子重计算中间张量释放 | mf#2448 |
| dsv4 报 meta→Ascend copy 不支持 | mint.empty 显式初始化 | mf#2411 |
| hc_sinkhorn_iters:0 被拦 | 合法配置，校验未对齐 Megatron | mf#2442 |
| hash router+pp 拉不起 | 过时校验，动态图 pp 已支持 | mf#2460 |
| 续训二阶段 loss 突变 | 冻结参数优化器状态，校验和快照+选择性重载 | mf#2490 |
| 续训缺 opt 文件报错含糊 | has_optimizer_ckpt 前置校验 | mf#2459 |
| 静态图 pp 加载权重失败 | 按各卡 rank 取 layout，勿用 0 卡 | mf#2335 |
| MLA TP 报模块不存在 | TP plan 按 q_lora_rank 条件收录 | mf#2292 |
考据与口径披露
- KG 核实 ：涉及机制/口径的核对用了昇腾知识图谱（ascend.wiki）官方文档与代码节点------DSA 稀疏注意力（cann-recipes-train deepseek-v32 预训练优化）、aclnnFlashAttentionVarlenScore、MLA 多头潜在注意力、custom FSDP 参数分片、MTP、零气泡流水线、expert_scales 更新、indexer KL loss 融合算子、FSDP 混合分片数据并行、h2d 拷贝开销、激活重计算显存手段、ASCEND_RT_VISIBLE_DEVICES、HcclCommDestroy、msmodeling DsV4 适配设计（hash 路由/HC Sinkhorn）、MindSpeed-LLM checkpoint_resume 优化器状态契约、PyPTO uninitialized-tensor FAQ（生态同口径，行内已标注非 MindSpore）；其余实现类主题 KG 无覆盖的条目 kg_refs 留空，未硬凑。
- PR 合并判定：一律以 pulls API state=merged+merged_at 判定（merged 字段恒为 null 不可用）；修复 PR 落在 docs 仓的（mindspore#29002/#29033 对应 docs#18291/#18299、#29054 对应 docs#18261/#18262、#29041 对应 docs#18412/18413）均经 docs 仓 pulls API 复核 merged；PR Fixes 多指向 atomgit/gitee 镜像或组织单（编号不同构），以正文语义+merged_at 佐证；抽 8 条硬时序断言对 API 复核通过（修复 PR 80259/8317/8619/8704/8550/92456、引入 PR 74073/8581、docs PR 18291；勘误：证据表把 #21812 修复 PR 80259 年份误记为 2026，API 实为 2025-01-06T19:40:17、与关单秒级一致，正文未涉年份）。
- 关联依据分层：秒级铁证 finished_at==merged_at 21 条（主仓 #21803/#21810/#21812 与差 99 秒的 #28907、mf #2302/#2329/#2349/#2338/#2292、#2275/#2278/#2330/#2332/#2334/#2448/#2468/#2524、#2459/#2460/#2475/#2490/#2335）；分钟级时间耦合（mf#2252 提单 56 分钟后合入、mf#2442 合入 6 分钟后关单、ms#28944 合入 20 分钟后关单、ms#28991 合入 1.5 小时后关单）；引入+修复双锚点（ms#21812 三锚点 74073→74745→80259、mf#2278 的 8205→8271、mf#2475 的 8581→8619、mf#2335 的 8191→8384、ms#21143 双 PR）；SSR 活动流显式关联（ms#28905/#28999/#28992/#21143）；Fixes/正文显式（mf#2234/#2290/#2252/#2398/#2380/#2257、ms#248 引入 PR 81218）；docs 仓 PR 修复（ms#29002/#29033 对应 docs#18291/#18299、#29054 对应 docs#18261/#18262、#29041 正文显式 Fixes）；评论解答/官方口径类无仓内 PR，以官方口径收录（ms#544/#29001/#28969/#29007/#28939、mf#2411 经正主 #2413 根因）；语义匹配+时间窗（ms#20673/#21705）。
- 时序陷阱实录：①dsv4 单卡三连 #2411/#2412/#2414 修复 PR 8493 关联的是正主 #2413（atomgit 链接），三连在 PR 合入前一日被人工批量关闭------重复单的关单时刻不能当 Fixes 依据（本篇以 #2411 落行并注明）；②「根因评论发布即关单」秒级系内部流程（mfC 正主 #2413 型、mf#2230 关单早于说明评论 2 分钟），时序不作 Fixes 依据；③mf#2380 评论宣称的修复 PR 8432 实际 closed 未合并，由 PR 8436 实质接替------单看评论会误判修复载体；④Fixes 指向 atomgit 镜像同号 issue 仍触发自动关单，指向组织级单（org-issues）则不关本仓 issue；⑤2026-06-18 17:24-17:28 与 2026-03-19 存在批量关单波，该时段 finished_at 均非修复时点，判据一律回 PR merged_at；⑥GitCode 74xxx PR 段初查 429 被误读为 404，退避后直验成功（429≠不存在）；PR SSR 页为客户端渲染空壳，PR 语义只能走 API；⑦SSR linked_merge_requests 可现 count=1 而数组空，需 walk 兜底+PR 窗口扫描（mf#2335）。
- 诚实弃收：本轮 109 候选 worker 层弃收 14------msD #21828（空任务模板）；msE #29011（官方索要环境信息无回应、stale 关闭无根因）、#29023（官方「非问题」三字关闭无根因）；mfA #2253（占位自提单）；mfB #2333（43 秒自点状态流占位单）、#2352（REJECTED→DONE 无公开依据为何DONE未核实）；mfC #2412/#2414（dsv4 三连重复单并入 #2411）、#2328（自带答案勘误+r1.5.0 不维护）、#2422（CVE 规则弃收）、#2494/#2500（运维/发布事务零证据）、#1961/#111（占位模板）。另 48 条深析合格但按 50 上限本轮未入选，留待续篇组稿（主仓 21：#20586/#20567/#29079/#28787、环境类评论解答 #28927/#28929/#28934/#28961/#28971/#28972、官网侧「已修复」无 PR 4 条 #28923/#28938/#28962/#28975、口径类 #28928/#28976/#28982/#29019/#29024/#29063/#29073；mf 27：#2211/#2220/#2280/#2322 等秒级与正文显式修复条目、#2397 关联 PR Fixes 指错+真修复 PR 未合入、#2284 模板注释 #123 触发 100 PR 关联上限、#2336 CogVLM2 停演进给替代机型、#2456/#2458/#2492 续训秒级条目等）。
- 候选统计与溢出：本篇 50 条 = 上篇拆入 3 条（#544/#248/#29041）+ 本轮 109 候选 5 批 worker 深析留 95（msD 23 留 22、msE 20 留 18、mfA 22 留 21、mfB 22 留 20、mfC 22 留 14）、共 98 池按质量取 47；余 48 条合格余量未裁撤质量、留待后续组稿。
接入昇腾知识图谱 https://gitcode.com/agent0/kg-tools
系列下一篇：mindspore 组织低评论长尾尚余 48 条深析合格余量（主仓 21 + mindformers 27），可续 mindspore 精选（四）·长尾余韵收束，或回归 cann/Ascend 线------欢迎留言点向。