Closed
[Bug|算子缺陷]: aclnnAvgPool2d/3d系列 divisorOverride参数(int64)kernel侧按float计算(白盒dtype检查发现) #562
Alice_zhouAdd on  9 days agoClosed at  2 days ago
Alice_zhou
Alice_zhouCollaborators
9 days ago Create

一、问题描述(必填)

  • 接口名: aclnnAvgPool2d、aclnnAvgPool2dBackward、aclnnAvgPool3d、aclnnAvgPool3dBackward(共用kernel) 参数: divisorOverride(int64_t 值类attr)
  • 发现方式: 白盒dtype一致性检查(whitebox-dtype-check CHK1-收窄),纯源码×资料静态核对
  • 检查日期: 2026-11-12 CANN: 9.3.0

二、代码证据(保留代码信息)

类型链核对: 签名=int64 ↔ 资料=int64 ↔ tiling读取=int64 ✓ ↔ kernel存储=int64 ✓ ↔ kernel计算=static_cast<float>(收窄)

  1. 头文件签名(权威): include/aclnnop/aclnn_avgpool2d.h:28
const int64_t divisorOverride, const int8_t cubeMathType,
  1. md资料: divisorOverride(int64_t),"取平均的除数。"(无取值范围——全量程 int64 合法;Backward 版资料另有 [-255,255] 描述)

  2. tiling 读取正确: ops-nn/pooling/avg_pool3_d/op_host/avg_pool3_d_tiling.cpp:620

const int64_t* divisorOverride = attrPtr->GetAttrPointer<int64_t>(DIVISOR_OVERRIDE_INDEX);
  1. kernel 存储正确: ops-nn/pooling/avg_pool3_d/op_kernel/avg_pool3d_common.h:71
int64_t divisorOverride;
  1. kernel 计算收窄点: ops-nn/pooling/avg_pool3_d/op_kernel/avg_pool3d_normal.h:344-345
if (divisorOverride) {
    mulsFactor = (float)1.0 / static_cast<float>(divisorOverride);
}

三、分析结论

divisorOverride 全链路(签名/资料/tiling读取/kernel存储)保持 int64,仅在 kernel 归一化因子计算处 static_cast<float> 转换为单精度:

  • float 仅 24 位尾数,divisorOverride > 2^24(16777216)即无法精确表示(如 16777217 → float 16777216.0),mulsFactor 计算产生精度偏差;
  • 前向接口资料无取值范围(全量程合法),大除数输入下平均池化结果与 int64 语义有偏差;建议 kernel 侧按 double/int64 计算或资料明示精度语义。

四、问题复现步骤(必填)

  1. 代码定位(无需设备): 对照 ops-nn/pooling/avg_pool3_d/op_kernel/avg_pool3d_normal.h:344-345 与头文件 aclnn_avgpool2d.h:28。
  2. 白盒检查复现:
git clone https://gitcode.com/Alice_zhou/Vector_fuzz_cpp_testing.git
cd Vector_fuzz_cpp_testing
python3 skills/whitebox-dtype-check/scripts/whitebox_dtype_check.py --apis aclnnAvgPool2d,aclnnAvgPool3d
# 输出: [P1][CHK1-类型链不一致] divisorOverride: read:op_kernel/avg_pool3d_normal.h=float≠int64
  1. 黑盒验证建议(可选): divisorOverride=16777217(2^24+1)对比 divisorOverride=16777216 的输出,float 无法区分二者。

五、附件与证据

  • 白盒检查明细: out_res/whitebox_dtype_check/aclnnAvgPool2d{,Backward}.json、aclnnAvgPool3d{,Backward}.json
  • 汇总报告: out_res/whitebox_dtype_check_report.md
likedislike
Alice_zhou
Alice_zhouCollaborators
8 days ago Comments:

已提单:DTS2026111319933

likedislike
Alice_zhou
Alice_zhouCollaborators
2 days ago Comments:

DTS 回归验证结果

  • 结果:通过
  • 问题单:DTS2026111319933
  • 修复类型:doc
  • 验证环境:100.102.205.195(root)
  • CANN 版本:9.3.0
  • CANN timestamp:20261119_120331807
  • 执行目录:/home/vector/30039325/issue
  • 执行命令:doc-review
  • 耗时:0 s
  • 忽略的无效用例:0 条
  • 意外放行(expected!=0, actual=0):0 条
  • 错误码不一致:0 条

关键日志

资料修复,未执行算子用例。

分析

ops-nn PR 14369 merged; avgpool2d/3d docs now state divisorOverride int64 but internally computed as FLOAT32, precision loss when abs(value)>2^24.

likedislike
Alice_zhouAlice_zhouCollaborators
2 days ago Close issue