HarmonyOS 上架审核:常见驳回原因与自检清单
上架驳回八成不是功能问题,而是首启那 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 个工作日准备 |
| 内容违规 | 名称图标、年龄分级 | 按商店规范逐项核对 |
五、自检清单:提交前按顺序过一遍
- 全新设备安装,录屏首启全过程,确认隐私弹窗先于任何权限与网络请求。
- 点"拒绝",确认应用不崩溃、不循环弹窗、有可浏览内容。
- 对照功能清单核对权限,删除所有未使用的声明。
- 定位类权限成对声明,
when一律inuse。 - 列出全部第三方 SDK 及收集信息,与隐私政策逐条对齐。
- 用另一台设备登录测试账号,确认不被风控拦截。
- 核对应用名称、图标、备案号、年龄分级四项与商店信息一致。
- 提交前用 Release 包而非 Debug 包自测,混淆后的崩溃表现不同。
- 点赞
- 收藏
- 关注作者
评论(0)