Pull Request has been successfully merged by CANN-robot.
(Thank you for liuyun_nj's contribution.)变更摘要
本 PR 围绕 AddRmsNorm/InplaceAddRmsNorm、DeepNorm、RmsNormQuant 等归一化算子,修复参数与 shape 校验缺失的 issue,并同步更新接口文档中的错误码说明。核心是补齐「非法输入在第一段(workspace 计算阶段)即返回声明错误码」的校验:tiling 与 aclnn 接口层新增对 epsilon 非有限值(NaN/±Inf)、InplaceAddRmsNorm 空 rstdOut、DeepNorm 的 mean/rstd 归约维非 1、RmsNormQuant 中 2 维 gamma/beta 首维不为 1 的拦截,并为上述场景补充 UT 覆盖。
主要改动
epsilon非有限值校验:norm/add_rms_norm/op_host/add_rms_norm_tiling.cpp的GetEpsilonParameter与Tiling4AddRmsNorm、以及aclnn_add_rms_norm.cpp的CheckAttr将epsilon < 0改为!std::isfinite(epsilon) || epsilon < 0,使NaN与+Inf不再被放行;错误信息同步改为「有限且大于等于 0」。InplaceAddRmsNorm空rstdOut拦截:CheckInputOutputShape在模式推导前按算子类型显式判断rstdOut的GetOriginShape().GetShapeSize() <= 0,并以OP_LOGE_FOR_INVALID_SHAPE_WITH_REASON在 tiling 第一段返回失败,避免被误判为PRE_RMS_NORM而跳过校验。DeepNorm归约维 shape 校验:deep_norm_tiling.cpp的CheckInputOutputShapeValue新增循环,要求mean/rstd在尾部的归约维(负数动态维除外)必须为 1,否则报 shape 非法,防止 kernel 按前导维乘积写入导致部分写或越界写。RmsNormQuant前置 shape 校验与错误码对齐:aclnn_rms_norm_quant.cpp在非 regbase 路径上于PreDealData之前调用CheckShapeBeforeReshape校验gamma/beta,使 2 维且首维非 1 的形态返回ACLNN_ERR_PARAM_INVALID(161002),而非后续Reshape的内部错误。- 测试与文档:新增
test_add_rms_norm_tiling.cpp(空rstdOut、非有限epsilon)、test_deep_norm_tiling.cpp(归约维非 1)、test_aclnn_rms_norm_quant.cpp(gamma/beta首维校验、dtype 不匹配、INT32 打包与 950 空 Tensor 场景)等用例;并按 PR 描述更新aclnnDeepNorm.md、aclnnGroupNorm.md、aclnnInplaceAddRmsNorm.md、aclnnRmsNorm.md的错误码说明。
🧩 本次 Review 已使用自定义 Skill:


代码审查
审查结论
各文件审查情况(7/7 已逐一审查)
| 文件 | 结论 |
|---|---|
norm/add_rms_norm/op_host/add_rms_norm_tiling.cpp |
1 处 P3(regbase 路径 epsilon 校验未同步);新增 InplaceAddRmsNorm 空 rstd 拒绝逻辑本身正确(位置早于 CheckInputOutputDim、nullptr 已判空、node type 与 IMPL_OP_OPTILING(InplaceAddRmsNorm) 一致,且不影响 AddRmsNorm 的 PRE/POST 模式推导) |
norm/add_rms_norm/op_host/op_api/aclnn_add_rms_norm.cpp |
无问题(CheckAttr 收紧为 `!std::isfinite |
norm/add_rms_norm/tests/ut/op_host/test_add_rms_norm_tiling.cpp |
2 处:P2(InplaceAddRmsNorm 空 rstd 用例对被测新代码无区分度)、P3(注释条件写反) |
norm/deep_norm/op_host/arch22/deep_norm_tiling.cpp |
1 处 P3(新增日志 invaild 拼写);归约维校验逻辑复核通过:xDimNum > gammaDimNum 与 meanDimNum/rstdDimNum == xDimNum 已由 CheckInputOutputShapeDim 前置保证,索引无越界,0 被拒、负数(动态维)跳过,与 arch35 的 CheckReduceOutputTail 行为一致 |
norm/deep_norm/tests/ut/op_host/arch22/test_deep_norm_tiling.cpp |
无问题(新用例有区分度:不加校验时该 shape 会返回 GRAPH_SUCCESS) |
norm/rms_norm_quant/op_host/op_api/aclnn_rms_norm_quant.cpp |
无问题(CheckShapeBeforeReshape 自带 nullptr 保护,前置到 PreDealData 之前与 regbase 顺序一致,返回 161002 符合 #7399) |
norm/rms_norm_quant/tests/ut/op_host/op_api/test_aclnn_rms_norm_quant.cpp |
无问题(改期望值的用例与新增 dtype/INT32 打包/空 Tensor 用例与现有校验分支逐一对应) |
计数
- P0:0
- P1:0
- P2:1
- P3:3
总体风险判断
本改动为「缺陷修复 + 校验补强」,主体逻辑方向正确、改动面小且均落在参数校验与 tiling 前置检查上,未触及 kernel、数据布局或 ABI,引入生产回归的风险低。两点需关注:一是新增 UT 对本次唯一的 InplaceAddRmsNorm 空 rstd 修复没有实际保护力(后续误删不会被发现);二是非有限 epsilon 的校验只落在 legacy tiling,regbase 路径仍为旧口径。另外提示:PR 描述称同步更新了 aclnnDeepNorm.md/aclnnGroupNorm.md/aclnnInplaceAddRmsNorm.md/aclnnRmsNorm.md,但本次 diff 中不含任何文档改动,相关 issue 的「资料口径」诉求在本提交内未体现,建议核对是否遗漏文件。
| 类型 | 数量 |
|---|---|
| 🔴 阻塞 | 0 |
| 🟡 建议 | 1 |
💬 仅评论
🧩 本次 Review 已使用自定义 Skill:


Thanks for your pull-request.
The full list of commands accepted by me can be found at here.
You can get sig-info at here.
You can self-configure the PR merge rules for this repository. For more details, please refer to Here.
For more, you also can visit HICANN.
PR Approval Progress
✅ Congratulations! All modules have met the lgtm and approve requirements.
Module Approval Details
| module | lgtm status | approve status |
|---|---|---|
| */*/docs/acl*.md | ✅ 冯英, 杜慧萍, 刘杰 (3/2) | ✅ 冯英, 杜慧萍 (2/1) |
| norm | ✅ 刘杰, 陈昊文 (2/2) | ✅ 刘杰, 陈昊文 (2/1) |
💡 Tip:
- Committer can comment
/approveor/lgtm- Commenting
/approveimplies both code review (lgtm) and intent to merge (approve)
CLA Signature Pass
liuyun_nj, thanks for your pull request. All authors of the commits have signed the CLA. 👍


compile


| 🚀 CI 流水线已启动 |
|---|
| 📋 执行详情: 点击查看流水线 |


🟡 Medium Priority
变更点:新增用例 inplace_add_rms_norm_empty_rstd_rejected(2813-2818 行设置 gamma=1 维 {64}、rstd={0},并在 2818 行把平台设为 Ascend950/NpuArch 3510),断言 tiling_func(...) == GRAPH_FAILED,注释称其覆盖本次新增的「InplaceAddRmsNorm 空 rstdOut 第一段拒绝」。
失效链:该用例的断言结果与被测新代码无关,两条路径都返回 GRAPH_FAILED:
- rstd origin shape {0} 使
norm_key = PRE_RMS_NORM(CheckNullptr,add_rms_norm_tiling.cpp:119-123),若 950 走 regbase 分支,Tiling4AddRmsNorm会在 add_rms_norm_tiling.cpp:543 以「regbase 不支持 PRE/POST」拒绝; - 若该 UT 的 950 配置被判定为非 regbase,则 PRE 模式要求 gamma 必须 2 维(add_rms_norm_tiling.cpp:207-212),本用例的 gamma 是 1 维 {64},同样返回 GRAPH_FAILED。
也就是说:把新增的 CheckInputOutputShape 里那段 InplaceAddRmsNorm 空 rstd 校验整段删掉,本用例仍然 PASS,本次修复的唯一回归保护实际不存在(这也是 #7407 中该行为在被发现前一直无 UT 覆盖的原因)。
建议:将该用例的平台配置由 Ascend950/NpuArch 3510 改为 Ascend910B(非 regbase),并把 gamma_shape 从 {64} 改为 {1, 64},使用例只有在新增的 InplaceAddRmsNorm 空 rstd 校验生效时才返回 GRAPH_FAILED,否则返回 GRAPH_SUCCESS,从而真正守护本次修改。


流水线分析报告 — ops-nn run#18800
流水线: https://gitcode.com/CANN/ops-nn/actions/runs/6576c570571340008c38d2c9afb6d474 | PR#14221 | 2026-11-11 16:07:08 ~ 16:14:50 | 失败 Job 1 个
定界结论: 代码问题 / LLT测试失败 — add_rms_norm op_api UT 5 个用例返回码不符
- 失败类型: 代码问题 / LLT测试失败
- 根因:
l2_add_rms_norm_test套件 5 个用例失败(75 例中 70 例通过), 全部是aclnnAddRmsNorm参数校验返回码与用例期望不一致(成功用例返回 161002, 非法 epsilon 用例返回 0)。 - 影响:
UT_Test_opapi下ut任务失败, 后续ut_report未启动; 同 run 的UT_Test_ophost/UT_Test_kernel/UT_Test_opgraph均通过, 编译阶段无报错。 - 处置建议: 提交者本地复跑该 op_api UT(
nn_op_api_ut --gtest_filter=l2_add_rms_norm_test.*)对齐实现与用例期望:- 若本地同样失败 → 用例期望与仓库当前校验行为不一致, 需按算子契约修正实现或更新用例断言(本 PR 触及
add_rms_normop_api, 需一并处理); - 若本地通过 → 为该 UT 任务运行环境/平台默认值差异, 重试并反馈 CI 维护者排查默认 SoC 配置。
- 若本地同样失败 → 用例期望与仓库当前校验行为不一致, 需按算子契约修正实现或更新用例断言(本 PR 触及
- 排除项: 非编译错误、非网络/设备/平台内部错误, 非 PR 冲突; 失败为确定性(同一二进制连续两轮执行失败集合完全一致)。
失败根因分析
根因 #1: 代码问题 / LLT测试失败 — l2_add_rms_norm_test 5 例断言失败
- 判据:
[ FAILED ] l2_add_rms_norm_test.*共 5 例, 失败断言集中在test_aclnn_add_rms_norm.cpp:44/87 - 定位步骤:
4_ut_acc.log(Run ops op_api utest with asan) - 影响 Job:
UT_Test_opapi/ut - 根因证据(日志原文):
[==========] 75 tests from 5 test suites ran. (235 ms total)
[ PASSED ] 70 tests.
[ FAILED ] 5 tests, listed below:
[ FAILED ] l2_add_rms_norm_test.timer_s1_bf16_success
[ FAILED ] l2_add_rms_norm_test.ascend950_reduce_empty_success
[ FAILED ] l2_add_rms_norm_test.epsilon_invalid_and_boundary
[ FAILED ] l2_add_rms_norm_test.base_formats_supported
[ FAILED ] l2_add_rms_norm_test.ascend950_exact_tail_and_empty_outputs_success
test_aclnn_add_rms_norm.cpp:44: Failure
Expected equality of these values:
aclRet Which is: 161002
expectRet Which is: 0
-
用例级明细:
用例 期望 实际 timer_s1_bf16_success SUCCESS(0) 161002 ascend950_reduce_empty_success SUCCESS(0) 161002 ascend950_exact_tail_and_empty_outputs_success SUCCESS(0) 161002 base_formats_supported SUCCESS(0) 161002 epsilon_invalid_and_boundary 负 epsilon / NaN → 161002; epsilon=0.0 → 0 负 epsilon / NaN → 0; epsilon=0.0 → 161002 -
补充论证: 本 PR 对
norm/add_rms_norm/op_host/op_api/aclnn_add_rms_norm.cpp的改动仅为CheckAttr的 epsilon 非有限值拦截(epsilon >= 0.0→!std::isfinite(epsilon) || epsilon < 0.0), 而失败集合中同时包含 epsilon 合法的"成功用例"(返回 161002)与非法 epsilon 用例(返回 0), 二者方向相反, 无法由该改动单独解释; 用例文件未在本 PR 变更列表中. 说明该算子 op_api UT 的期望与当前仓库校验行为(含默认 SoC/regbase 分支)已不一致, 本 PR 因触及add_rms_norm触发该 UT 构建而暴露. 建议按上述双路径处置, 避免误判为单纯重试可解.
结构化定界摘要
[{"repo": "ops-nn", "run_number": 18800, "Failed_Type": "代码问题", "Failed_Sub_Type": "LLT测试失败", "Failed_Reason": "add_rms_norm op_api UT 5 个用例返回码与期望不符: 4 个成功用例返回 161002(参数非法), epsilon_invalid_and_boundary 中负 epsilon/NaN 返回 0、epsilon=0.0 返回 161002, 用例期望与实现校验行为不一致", "evidence": "[ FAILED ] 5 tests, listed below: l2_add_rms_norm_test.timer_s1_bf16_success / ascend950_reduce_empty_success / epsilon_invalid_and_boundary / base_formats_supported / ascend950_exact_tail_and_empty_outputs_success; test_aclnn_add_rms_norm.cpp:44: Failure, aclRet 161002 vs expectRet 0", "suggestion": "提交者本地复跑该 op_api UT 对齐实现与用例期望; 本地也失败则修正实现或更新断言, 本地通过则按 UT 运行环境问题重试并反馈 CI 维护者", "jobs": "UT_Test_opapi,ut"}]
由门禁失败定界分析自动生成 | repo: ops-nn | run: 6576c570571340008c38d2c9afb6d474 | PR#14221


compile


| 🚀 CI 流水线已启动 |
|---|
| 📋 执行详情: 点击查看流水线 |


/lgtm
/approve


/lgtm
/approve


/lgtm
/approve


代码检视报告(PR #14221)
结论:暂不 approve。 存在 1 项重要(正确性)问题、2 项次要问题;评论区还有 2 条已标记 resolved 但 head(1f56c94f)代码未落实的意见。
🟡 重要(正确性,未修复)
norm/add_rms_norm/op_host/add_rms_norm_tiling_arch35.cpp:498(regbase 路径 epsilon 校验未同步)- 代码:
OP_CHECK_IF(*epsilon < 0, OP_LOGE(context, "epsilon must be nonnegative, but got %f.", *epsilon), ...) - 问题:本 PR 在 legacy tiling(
add_rms_norm_tiling.cpp:402与:558)把判据改成!std::isfinite(epsilon) || epsilon < 0,但 regbase(arch35)路径仍是*epsilon < 0。NaN与任何比较恒为假、+Inf >= 0为真,二者在 950(regbase)上依旧被放行,随后tiling.set_epsilon(*epsilon)把非有限值写进 tiling data,污染全部输出——即 issue #7397 在 regbase 平台上仍未修复。 - 影响面:aclnn 层
aclnn_add_rms_norm.cpp的CheckAttr已用std::isfinite拦住,所以经 aclnn 接口调用不受影响;但直接走 GE/IR 图执行(tiling 是契约落点)时仍可复现。 - 建议:把 arch35 的判据同步为
!std::isfinite(*epsilon) || *epsilon < 0,并补一条 regbase(Ascend950/NpuArch 3510)下的非有限 epsilon 用例。
- 代码:
🟢 次要(建议,不阻断)
norm/add_rms_norm/tests/ut/op_host/test_add_rms_norm_tiling.cpp:97-179(inplace_add_rms_norm_empty_rstd_rejected无区分度)- 该用例配 Ascend950/NpuArch 3510 + gamma 1 维
{64},而 rstd origin shape{0}会让norm_key = PRE_RMS_NORM:走 regbase 分支时Tiling4AddRmsNorm:541-547会因「regbase 不支持 PRE/POST」直接返回GRAPH_FAILED;即便被判为非 regbase,PRE 模式要求 gamma 为 2 维(add_rms_norm_tiling.cpp:207-212),1 维 gamma 同样失败。也就是说把本次新增的 InplaceAddRmsNorm 空 rstd 校验整段删掉,该用例仍然 PASS——本次修复的唯一回归保护实际不存在。 - 建议:平台改为 Ascend910B(非 regbase)、gamma 改为
{1, 64},使用例只在新增校验生效时返回GRAPH_FAILED。
- 该用例配 Ascend950/NpuArch 3510 + gamma 1 维
test_add_rms_norm_tiling.cpp:237-238:注释写「!(std::isfinite(epsilon) || epsilon < 0)拦截」,实际实现是!std::isfinite(epsilon) || epsilon < 0,注释条件写反,建议更正以免误导后续维护。norm/deep_norm/op_host/arch22/deep_norm_tiling.cpp:308:新增日志文案invaild拼写错误(应为invalid,同函数既有日志也是这个拼写,可一并修正)。
已确认正确的部分
add_rms_norm_tiling.cpp的 InplaceAddRmsNorm 空 rstdOut 拒绝逻辑位置正确(早于CheckInputOutputDim、已判空、node type 与IMPL_OP_OPTILING(InplaceAddRmsNorm)一致),且不影响 AddRmsNorm 以空 rstd 选择 PRE/POST 模式的既有用法。deep_norm_tiling.cpp归约维必须为 1 的校验:xDimNum > gammaDimNum与meanDimNum/rstdDimNum == xDimNum已由CheckInputOutputShapeDim前置保证,索引无越界,0被拒、负数(动态维)跳过,与 arch35 的CheckReduceOutputTail行为一致;配套 UT 有区分度。aclnn_rms_norm_quant.cpp把CheckShapeBeforeReshape前置到PreDealData之前(非 regbase),使 2 维且首维非 1 的 gamma/beta 返回 161002 而非 Reshape 内部错误 561103,与 regbase 顺序一致,符合 #7399。- 文档改动(
aclnnDeepNorm.md拆分 161002/561002、aclnnGroupNorm.md与aclnnInplaceAddRmsNorm.md补空 Tensor 约定、aclnnRmsNorm.md补 n=0 语义)与代码行为一致。
备注
- 评论区 2 条意见已被标记
resolved=true但 head 代码未落实:atomgit-bot 的 P2(inplace_add_rms_norm_empty_rstd_rejected无区分度,即本报告第 2 项)与 P3(regbase 路径 epsilon 校验未同步,即本报告第 1 项)。请作者确认是漏改还是有意延后。 - 标签含
stat/needs-squash,合入前需 squash。


/approve


Pull Request 已合并或已关闭。
If you want to solve this problem, you can click here to do it in the FAQs.


描述
修复issue问题,补充shape校验和文档错误码说明
关联的Issue
#7296 #7297 #7363 #7397 #7398#7399 #7407 #7432
测试
文档更新
aclnnDeepNorm.md
aclnnGroupNorm.md
aclnnInplaceAddRmsNorm.md
aclnnRmsNorm.md
类型标签
AI/Agent生成声明