Closed
[Documentation|文档反馈]: aclnnGroupNorm 资料未说明空 Tensor 时 out/meanOut/rstdOut 的取值(实测 rstdOut=NaN) #7363
liuhanwen8Add on  27 days agoClosed at  6 days ago
liuhanwen8
liuhanwen8
27 days ago Create

现象

aclnnGroupNorm 的资料在参数表里 6 次声明「支持空Tensor」,但全文没有规定空输入时 out / meanOut / rstdOut 应该输出什么。实测(Atlas A2)三种空 Tensor 形态:

输入 两段返回 out meanOut (N,group) rstdOut (N,group)
合法非空 [2,8,16] 0 / 0 正常 正常 正常
HxW=0,[2,8,0] 0 / 0 空 全 0 全 NaN
C=0,[2,0,16] 0 / 0 空 全 0 全 NaN
N=0,[0,8,16] 0 / 0 空 空 空

关键点:meanOut / rstdOut 的形状只由 (N, group) 决定,与 C、HxW 无关。因此 HxW=0 与 C=0 时这两个出参非空,调用方能直接读到「均值 0 + 倒数标准差 NaN」这一组不自洽的值;而 N=0 时它们才是空张量。资料没有区分这三种情况。

期望

资料应写明空 Tensor 时三个出参的取值。实现意图已写在源码注释里(meanOut 输出 0、rstdOut 输出 NAN、out 不写),资料应与之对齐,并区分 N=0(三出参皆空)与 HxW=0/C=0(meanOut/rstdOut 非空、填 0/NaN)。

或者反向对齐:与同仓 #7246(aclnnGroupNormBackward 的 N=0 空 tensor 缺陷)一致,明确 N=0/C=0 的契约(拒绝并返回 161002)——当前 aclnnGroupNorm 对这两种输入返回 0。

环境

  • 硬件:Atlas A2 训练系列(Ascend 910B2),npu-smi 26.1.1
  • 软件:CANN 9.2.0(Linux aarch64)
  • 仓库与提交:cann/ops-nn 779c90413fe3(git fetch 后的 master;代码 norm/group_norm/op_host/op_api/aclnn_group_norm.cpp 376-383 行与资料 6 处「支持空Tensor」声明均仍在)
  • 复现日期:2026-10-26

复现步骤

  1. 将下方脚本保存为 doc_assert_gn_empty.py
  2. 在 cann/ops-nn 仓根执行:python3 doc_assert_gn_empty.py --repo-root <ops-nn 仓根>
  3. 观察输出末行为 [DEFECT] ...,退出码为 1
  4. (可选,板上实测 0/NaN)按第 4 节代码块编译运行 C++ 探针

复现脚本

#!/usr/bin/env python3
# -*- coding: utf-8 -*-
"""aclnnGroupNorm 资料:空 Tensor 出参取值契约的文本断言。
缺失 → [DEFECT] + 退出码 1;已写清 → [OK] + 0;无法判定 → 2。"""
import argparse, os, re, sys

def main():
    ap = argparse.ArgumentParser()
    ap.add_argument("--repo-root", required=True)
    a = ap.parse_args()
    doc = os.path.join(a.repo_root, "norm/group_norm/docs/aclnnGroupNorm.md")
    if not os.path.isfile(doc):
        print("[UNKNOWN] 找不到 %s" % doc); return 2
    text = open(doc, encoding="utf-8").read()
    claims = len(re.findall(r"支持空\s*Tensor", text, re.I))
    print("资料路径: %s" % os.path.relpath(doc, a.repo_root))
    print("「支持空Tensor」声明次数: %d" % claims)
    if claims < 1:
        print("[UNKNOWN] 资料未声明支持空 Tensor,本断言不适用"); return 2
    # 契约段落:同一段同时出现 空Tensor + (meanOut|rstdOut) + (0|NaN)
    paras = re.split(r"\n\s*\n", text)
    spec = [p for p in paras if re.search(r"空\s*Tensor", p, re.I)
            and re.search(r"meanOut|rstdOut", p)
            and re.search(r"\bNAN\b|\bNaN\b|输出\s*0|填\s*0", p)]
    if spec:
        print("[OK] 已找到空 Tensor 取值契约: %s" % spec[0][:120].replace("\n", " "))
        return 0
    print("[DEFECT] 资料 6 处声明「支持空Tensor」,但未规定空 Tensor 时 "
          "out/meanOut/rstdOut 的取值;实测 HxW=0 / C=0 时 meanOut 全 0、rstdOut 全 NaN"
          "(两出参形状 (N,group) 非空)。")
    return 1

if __name__ == "__main__":
    sys.exit(main())

实测输出:

资料路径: norm/group_norm/docs/aclnnGroupNorm.md
「支持空Tensor」声明次数: 6
[DEFECT] 资料 6 处声明「支持空Tensor」,但未规定空 Tensor 时 out/meanOut/rstdOut 的取值;实测 HxW=0 / C=0 时 meanOut 全 0、rstdOut 全 NaN(两出参形状 (N,group) 非空)。

板上实测(HxW=0,self=fp32[2x8x0],group=4,eps=1e-5,输出缓冲预填哨兵 777.0):

ret=0/0  out: nan=0/0 sentinel777=0
meanOut[0..3]=0.000000 0.000000 0.000000 0.000000  sentinel777=0/8
rstdOut[0..3]=nan nan nan nan  sentinel777=0/8

哨兵残留为 0,说明 0 与 NaN 是算子写入值,不是未初始化内存。

影响

  • 调用方无法据此写断言:NaN 会被多数框架当异常值,0 又会被误当「真实均值」消费;两者同时出现时无法判断哪个是「空输入」的约定值。
  • 同一接口族行为不一致:aclnnGroupNormBackward 的 N=0 空 tensor 已被当作缺陷(#7246),而正向接口对 N=0/C=0 直接返回 0 且给出 0/NaN 取值,资料未做区分。
  • 迁移成本:从 aclnnGroupNormSilu(A2 对 N<=0/C<=0 返回 161002)迁到 aclnnGroupNorm 时,空张量路径的契约完全不同,且无文档可依。

建议

在 aclnnGroupNorm.md 的「约束说明」或「功能说明」补一段空 Tensor 契约,至少覆盖三点:

  1. 空 Tensor 判定为 self.numel()==0,out 不写(本身为空);
  2. meanOut 输出 0、rstdOut 输出 NaN(与源码注释一致),并说明这是约定值而非计算结果;
  3. 区分 N=0(三出参皆空)与 HxW=0/C=0(meanOut/rstdOut 形状 (N,group) 非空)。

若维护者认为 N<=0/C<=0 不应被接受,则改为返回 161002,并与 #7246 的处理口径统一。

likedislike
liuhanwen8liuhanwen8
27 days ago Added label: documentation
yuning_chen
yuning_chenCollaborators
26 days ago Comments:

初步分析

感谢反馈,我们已开始核对这个问题。

现象理解:文档反馈;aclnnGroupNorm 资料未说明空 Tensor 时 out/meanOut/rstdOut 的取值(实测 rstdOut=NaN)。
当前判断:从描述看,这是资料/注释与实现口径不一致类文档反馈「aclnnGroupNorm 资料未说明空 Tensor 时 out/meanOut/rstdOut 的取值(实测 rstdOut=NaN)」。需要对照接口文档、头文件注释与实现/实测结果核对哪一侧需修正。以上为初步判断,待复现确认,不能当成已确认根因。
涉及范围:aclnnGroupNorm、aclnnGroupNormBackward、aclnn_group_norm
下一步:我们会先核对文档声明与实现/测试结果是否一致,再决定改资料还是改代码。

likedislike
yuning_chenyuning_chenCollaborators
25 days ago Assign liujie12345678 as responsible person
yuning_chen
yuning_chenCollaborators
25 days ago Comments:

您好,问题已收到,当前 @liujie12345678 正在处理中。

likedislike
liujie12345678liujie12345678Collaborators
25 days ago Assign gitee-duhuiping as responsible person
liujie12345678liujie12345678Collaborators
25 days ago Removed responsible person liujie12345678
liuyun_njliuyun_njCollaborators
11 days ago Associated pull request
gitee-duhuipinggitee-duhuipingCollaborators
6 days ago changed custom state from 进行中 to 已完成
gitee-duhuipinggitee-duhuipingCollaborators
6 days ago Close issue
chenjiayi_chenjiayi_Collaborators
3 days ago Assign chenjiayi_ as responsible person
chenjiayi_
chenjiayi_Collaborators
3 days ago Comments:

补充说明本问题的后续处理:

已修复并随关联 PR 合入。

处理结果:

  • !14221:fix issue,add md doc,add check shape

验证:

  • 关联 PR(2026-11-13)已合入,变更可从 PR 记录追溯。
  • 本次以 PR 记录与 issue 讨论核对为主,未重新执行复现或真机验证。

说明:合入分支与版本以 PR 记录为准;如仍有问题,请重新提 issue 并附版本、shape 与日志。

如果还有后续需要,请重新提 issue。

likedislike
chenjiayi_chenjiayi_Collaborators
1 day ago Removed responsible person chenjiayi_