HarmonyOS 上架审核:常见驳回原因与自检清单

举报
yd_260750576 发表于 2026/11/13 08:32:03 2026/11/13
【摘要】 上架驳回八成不是功能问题,而是首启那 30 秒里的合规问题:隐私政策没弹、权限提前申请、SDK 提前初始化。把这三件事按顺序做对,能挡掉大部分一次驳回。剩下的才是资质与内容问题。 一、驳回集中在首启

上架驳回八成不是功能问题,而是首启那 30 秒里的合规问题:隐私政策没弹、权限提前申请、SDK 提前初始化。把这三件事按顺序做对,能挡掉大部分一次驳回。剩下的才是资质与内容问题。

一、驳回集中在首启 30 秒,不在功能深处

审核员的路径很短:安装、冷启动、看首屏、点几个主要入口、翻设置页。整个过程通常不超过五分钟。所以你的功能做得再复杂,审核看到的就是首屏和几个跳转。

这意味着自检的重点应该放在"第一屏能不能自证合规",而不是"功能全不全"。我审过自己的包,用录屏计时:从点击图标到首屏可交互 2.1 秒,隐私弹窗如果在这之后才出现,就属于"先收集后告知"。

首启 30 秒内必须满足四条:未同意隐私政策前不弹任何权限申请、不初始化任何第三方 SDK、不读取设备标识、不发起业务网络请求。这四条任何一条破了,都够驳回一次。自检时不要用开发机,找一台恢复出厂设置的设备,插一张没装过该应用的账号,从应用市场下载安装包走一遍。开发机上残留的登录态、缓存的隐私同意记录,会让问题完全消失。

二、权限三件套:声明、理由、时机,缺一不可

module.json5 里的权限声明不是写上就完事。user_grant 权限必须提供 reason(用户能看懂的一句话)和 usedScene(哪个 Ability、什么时候用),缺一个就可能在审核时被判定为"权限用途不明确"。

还有一个高频错误:申请了权限但代码里没用到。审核侧能通过静态扫描看到权限列表,申请了定位却没有定位功能,会被要求删除。反过来,用了能力但没声明,运行时报错,功能演示直接失败。

申请时机同样影响判定。requestPermissionsFromUser 必须由用户操作触发,且要传当前页面的 UIAbilityContext。在 onCreate 里直接申请,属于"启动即索权",是高频驳回项。更稳的写法是在按钮点击回调里申请,申请前用一句话说明用途,用户拒绝后给出可继续使用的降级路径。

定位权限有个特殊规则:申请精确位置必须同时申请模糊位置,两个一起声明、一起弹窗,否则系统会拒绝。这个细节文档里有,但很容易漏。

// entry/src/main/module.json5
{
  "module": {
    "requestPermissions": [
      {
        "name": "ohos.permission.INTERNET"
      },
      {
        "name": "ohos.permission.APPROXIMATELY_LOCATION",
        "reason": "$string:reason_location",
        "usedScene": {
          "abilities": ["EntryAbility"],
          "when": "inuse"          // 仅前台使用,不要写 always
        }
      },
      {
        "name": "ohos.permission.LOCATION",
        "reason": "$string:reason_location",
        "usedScene": {
          "abilities": ["EntryAbility"],
          "when": "inuse"
        }
      }
    ]
  }
}

when 只有 inuse 和 always 两个值。除非是导航、运动记录这类确实需要后台定位的场景,一律写 inuse。写 always 会触发更严格的审核,还要额外说明后台必要性。

三、隐私政策的顺序错一步,全盘皆输

正确顺序是:冷启动 → 展示隐私政策弹窗(含协议链接、拒绝按钮)→ 用户点击同意 → 初始化 SDK、申请权限、发起请求。注意"拒绝"也必须是有效路径:拒绝后能浏览不依赖个人信息的内容,或者直接退出,不能卡在死循环。

常见的三种错误写法:一是弹窗只有"同意",没有"拒绝";二是同意前已经初始化了统计 SDK;三是把隐私政策藏在设置页,首启不弹。第三种在近两年是重点检查项。

第三方 SDK 也要单独列清单,包含 SDK 名称、收集的信息类型、使用目的、隐私政策链接。一个包集成十几个 SDK 很常见,漏列一个就可能是"未如实告知"。

检查方法是用抓包工具跑一遍首启,看有哪些域名在隐私同意前就被请求了。这个方法比翻代码可靠,因为很多 SDK 是在 so 里发的请求,代码里根本搜不到。我每次提审前都跑一遍,几乎每次都能抓到一两个漏网的统计域名。

四、软性驳回:名称、图标、分级、测试账号

这些不涉及代码,但同样高频。应用名称和图标必须与商店填写一致,图标不能带"测试""内测"字样,不能使用华为自有品牌的元素。年龄分级要按内容如实填写,含社交、付费、抽奖的必须选对应项,选低了会被要求整改。

需要登录才能完整体验的应用,必须在审核备注里提供可用账号和密码,且账号在审核期间不能失效、不能触发短信验证码。我吃过一次亏:测试账号绑定了固定设备,审核员在另一台机器登录被风控拦截,直接驳回"无法完整体验"。

还有一个容易忘的:备案信息。国内上架需要在应用信息里填写备案号,主体名称必须与开发者账号一致,不一致会被打回。

版本更新说明也别糊弄。写"修复已知问题"的版本,如果实际新增了付费功能或权限,审核会按"描述与实际不符"处理。我的写法是三句话:改了什么、影响哪个功能、有没有新增权限。长度控制在 100 字内,反而更容易过。

还有一条时间成本要提前算:首次提交的审核通常在 1 到 3 个工作日,被驳回后重新提交要重新排队。如果排期卡在发布日,第一次提交至少提前两周,别把审核当成当天能过的环节。

驳回类型 判定点 自检动作
隐私政策 首启未弹、无拒绝路径 录屏走一遍拒绝流程
权限滥用 声明未使用、理由含糊 逐条对照功能清单删权限
SDK 未告知 清单缺失或与实际不符 反编译查 so 与网络域名
功能不完整 审核无法进入核心页 提供稳定测试账号并备注路径
资质缺失 备案号、特殊行业许可 提前 15 个工作日准备
内容违规 名称图标、年龄分级 按商店规范逐项核对

五、自检清单:提交前按顺序过一遍

  1. 全新设备安装,录屏首启全过程,确认隐私弹窗先于任何权限与网络请求。
  2. 点"拒绝",确认应用不崩溃、不循环弹窗、有可浏览内容。
  3. 对照功能清单核对权限,删除所有未使用的声明。
  4. 定位类权限成对声明,when 一律 inuse。
  5. 列出全部第三方 SDK 及收集信息,与隐私政策逐条对齐。
  6. 用另一台设备登录测试账号,确认不被风控拦截。
  7. 核对应用名称、图标、备案号、年龄分级四项与商店信息一致。
  8. 提交前用 Release 包而非 Debug 包自测,混淆后的崩溃表现不同。
【声明】本内容来自华为云开发者社区博主,不代表华为云及华为云开发者社区的观点和立场。转载时必须标注文章的来源(华为云社区)、文章链接、文章作者等基本信息,否则作者和本社区有权追究责任。如果您发现本社区中有涉嫌抄袭的内容,欢迎发送邮件进行举报,并提供相关证据,一经查实,本社区将立刻删除涉嫌侵权内容,举报邮箱: cloudbbs@huaweicloud.com
  • 点赞
  • 收藏
  • 关注作者

评论(0)

0/1000
抱歉,系统识别当前为高风险访问,暂不支持该操作

全部回复

上滑加载中

设置昵称

在此一键设置昵称,即可参与社区互动!

*长度不超过10个汉字或20个英文字符,设置后3个月内不可修改。

*长度不超过10个汉字或20个英文字符,设置后3个月内不可修改。