★ FEATURED ARTICLE 摘要: 应用开发完卡在上架环节整整一周第一次提交被驳回签名错误、第二次被驳回缺隐私政策、第三次被驳回权限声明过度……每次驳回都要等 1-3 天审核来回折腾了一周。后来我把华为应用市场的驳回原因做了系统整理发现90% 的驳回都集中在 5 类问题上全是提交前可以自查的。本文用第一人称复盘我的上架过程从开发者实名认证、AGC 项目创建、证书签名配置到构建 Release 包与提交审核重点拆解 5 个高频驳回原因与整改方案附完整材料清单与自查清单帮你一次过审。适用版本: HarmonyOS NEXT 7.x / AGC / 华为应用市场2026 年政策以官方最新为准难度等级: ⭐⭐ |前置知识: 建议先阅读第 1 篇《环境搭建与工程结构》——本文是上架实操篇不涉及 ArkUI 编码开篇包构建好了上架被驳回 3 次“你的应用被驳回了原因见邮件。”2026 年 8 月下旬涟漪睡眠 App 开发完我提交了华为应用市场审核。两天后收到驳回邮件附件里是审核截图红字标注“签名与上传包不一致”。我一脸懵签名不是自动生成的吗怎么会不一致后来才发现我在 DevEco Studio 里改了 bundleName 后没有重新生成签名导致上传的包用的是旧证书。这只是我上架噩梦的开始。接下来一周我又被驳回了两次三次驳回的原因和成本是这样的次数驳回原因处理成本第 1 次签名与上传包不一致重签 重新上传等 2 天第 2 次缺少隐私政策链接补页面 重新提交等 2 天第 3 次权限声明与实际使用不符改权限 重新提交等 3 天一周时间全耗在等审核上。痛定思痛我把上架全流程和驳回原因整理成了系统清单后面 3 个同事上架全部一次过审。这篇文章就是这套流程的完整版。先看全局鸿蒙应用的签名体系围绕 AGC 展开——证书证明开发者身份Profile 把证书和包名绑在一起签名配置再把两者接到构建流程上。理清这四者的关系后面所有的驳回问题都有了解释框架。一、上架前准备实名认证与 AGC 项目1.1 开发者实名认证坑 1实名认证不提前做卡在最后一步我的第一个教训应用开发完才去实名认证认证审核又等了 2 天。实名认证应该项目启动第一天就做和开发并行。1.2 AGC 创建项目与应用AGCAppGallery Connect是上架的中枢项目和应用在这里创建包名在这里登记证书和 Profile 也在这里管理。这一步唯一要死磕的就是包名一致性。入口: AppGallery Connect (AGC) → 我的项目 → 创建项目 流程: 创建项目 → 添加应用 → 填写应用信息包名/名称/图标 包名: 必须与工程 bundleName 完全一致含大小写坑 2AGC 包名与工程 bundleName 不一致现象: 上传安装包时报包名与应用不匹配 根因: AGC 里填的包名和工程 AppScope/app.json5 的 bundleName 不一致 解法: 两边严格一致改任何一边都要同步另一边的签名为什么包名不一致会导致签名失效因为 Profile 是绑定具体包名下发的——包名一改旧 Profile 就不再匹配新包名构建出的包自然过不了 AGC 的校验。这也是我第一次被驳回“签名与上传包不一致”的根本机制。二、证书与签名配置易出错的环节2.1 证书体系总览签名配置的完整链路如下图证书和 Profile 从 AGC 下发汇入工程的 signingConfigs再按构建类型分流成调试包和上架包。证书用途生成方式我的踩坑Debug 证书开发调试自动签名生成—Release 证书上架发布AGC 手动创建私钥丢了无法补坑 3Profile绑定证书包名自动/手动改包名后必须重建2.2 自动签名DevEco Studio 推荐方式DevEco Studio → File → Project Structure → Signing Configs → 勾选 Automatically generate signature → 登录华为账号 → 自动完成 证书Profile 关联注意自动签名生成的是调试证书只绑定调试设备、用于真机调试AGC 提审时上传的必须是发布证书签的包——发布证书只能在 AGC 手动创建这是两种证书用途上的硬性区分。坑 3Release 私钥丢失应用无法更新这是我见过代价最大的签名事故值得单独展开现象: 应用上架后想发新版本但找不到当初签名的私钥文件 根因: Release 证书私钥只保留在签名时那台机器丢了无法补签 解法: 私钥文件.p12多副本备份网盘U 盘换电脑前先导出2.3 发布证书Release入口: AGC → 用户与访问 → 证书管理 → 创建证书 要点: 生成 .cer 和 .p12.p12 的密码要记牢丢失无法找回三、构建 Release 包与提交审核3.1 构建签名 Release 包构建本身不难难的是传什么、怎么验。下图是提交审核的完整决策路径——每种驳回原因对应一条整改回流线从图里能直观看出所有驳回最终都回到重新提交这一个节点整改质量决定你要绕几圈。具体的构建方式有两种界面操作或命令行二选一DevEco Studio 中Build → Build Hap(s)/APP(s) → Build APP(s) 或命令行构建 hvigorw assembleApp --mode module -p productdefault 构建产物路径 entry/build/default/outputs/default/xxx-signed.app提交前必做每一条都有明确的为什么:# 1. 验证包名与 AGC 一致grepbundleName AppScope/app.json5# 2. 验证签名用 keytool 查看证书指纹keytool-printcert-jarfilexxx-signed.app|grepSHA256# 3. 真机安装验证提交前必装一次hdcinstallxxx-signed.app3.2 提交审核材料清单材料要求易漏点应用图标512×512无圆角用带圆角的图会被驳回应用截图手机/平板各 2-5 张需含真实功能界面隐私政策可访问的网页链接必须有独立 URL应用介绍简要 详细不能夸大功能权限说明逐项声明用途与实际调用一致3.3 提交后审核流程提交后的审核链路是开发者上传材料AGC 分发到审核侧审核结果按原因分流——这个过程我踩过的每一类驳回都对应下面时序图里的一条回流线。提交 → 机审几小时→ 人审1-3 天→ 通过/驳回 驳回会附截图与原因按原因整改后重新提交四、5 个高频驳回原因与整改方案驳回 1签名错误安装包无法安装现象: 审核机安装失败提示签名验证失败 根因: 上传的包签名与 AGC 登记不一致改过 bundleName/换过机器 整改: 重新自动签名 → 重新构建 → 本地 hdc install 验证通过后再传 验证: 整改后先 keytool 对比包的证书指纹与 AGC 登记一致再 hdc install 真机装一次装得上才传驳回 2缺少隐私政策现象: 驳回截图标注未提供隐私政策链接 根因: 上架信息里没填隐私政策 URL或链接无法访问 整改: 部署一个可公开访问的隐私政策页面URL 填入上架信息 验证: 用浏览器无痕模式打开该 URL 确认可访问并核对页面含下方 5 项要素、应用内也留了入口整改模板隐私政策必须包含的 5 项:1. 收集哪些信息账号、设备信息 2. 收集目的与用途 3. 第三方 SDK 共享清单统计/广告 4. 用户权利查询/删除/注销 5. 联系方式与更新日期驳回 3权限声明过度现象: 审核发现申请了相机/定位权限但功能里没用 根因: module.json5 声明了未实际使用的敏感权限 整改: 只声明实际使用的权限用到的权限在审核时说明场景为什么声明了但没用也算问题因为敏感权限一旦声明用户在安装时就会被告知该应用可能使用相机审核侧视同功能承诺——声明了却拿不出使用场景等于材料自相矛盾。下面是涟漪睡眠实际使用的最小权限集// 正确只声明真实使用的权限 requestPermissions: [ { name: ohos.permission.INTERNET }, // 没有相机功能绝不声明 ohos.permission.CAMERA ]驳回 4应用截图与功能不符现象: 截图是模拟数据/占位图审核认为货不对板 根因: 截图用的假数据或包含未上线功能 整改: 截图用真实功能界面 真实数据不展示未实现功能驳回 5应用介绍夸大功能现象: 介绍里写了AI 智能推荐实际只是简单排序 根因: 介绍文案夸大审核实测不符 整改: 文案与实际功能严格对应AI 类功能需提供说明五、提交前自查清单收藏级提交前逐项勾选全绿再点提交#检查项检查方法1bundleName 与 AGC 完全一致对比 app.json5 与 AGC2签名可安装hdc install 实测3隐私政策 URL 可访问浏览器打开验证4权限仅声明实际使用逐个权限对照功能5截图真实无占位肉眼检查每张6图标 512×512 无圆角尺寸检查7版本号高于已上架版本versionCode 递增8隐私政策含 5 大要素逐项核对9介绍文案无夸大与实际功能对照10真机回归一遍核心流程安装后走主流程六、总结环节关键动作一句话记忆前置准备实名认证提前做别等开发完再认证签名配置Release 私钥多备份私钥丢了无法补构建验证hdc install 实测本地装不上就别传审核材料隐私政策必须有 URL5 大要素齐全权限声明只用真实权限声明过度必被驳回核心认知: 上架 配置一致性包名/签名 材料完备隐私/截图/权限 提交前自查。这三件事做对一次过审是常态——我第一次上架被驳回 3 次、耗时 12 天后面按清单自查后一次通过、4 天上架。被驳回的原因全部集中在材料侧没有一个是因为代码问题上架卡住的大多数情况问题出在提交前没按清单自查而不是应用本身。90% 的驳回都是材料与配置问题提交前 30 分钟按清单自查一遍能省下一周。你上架时被驳回过几次因为什么原因评论区聊聊我帮你分析怎么整改。边界与已知限制限制项具体表现规避方式审核政策审核规则持续更新旧经验会失效提交前查阅官方最新要求包名一致AGC 包名与工程 bundleName 不一致无法提交构建前统一校验证书有效期发布证书与 Profile 有有效期过期构建失败到期前重新生成并更新配置隐私政策必须有可访问 URL且应用内要有入口URL 与应用内入口都要配权限声明声明超出实际使用范围必被驳回按最小集申请并写明使用场景截图规格尺寸、内容、截图设备不符会被驳回按官方规格出图并复核测试账号审核无法登录会直接被拒提供可用演示账号与演示视频版本号版本号必须递增重复无法上传出包前确认 versionCode 已递增政策时效说明: 本文基于 2026 年华为应用市场审核政策。审核规则会更新提交前务必查阅 AppGallery Connect 官方最新要求。专栏导航上一篇: 冷启动从 2.8s 优化到 0.9s——耗时拆解与数据对比实战下一篇: 元服务开发与生态变现——免安装卡片实战及五条变现路径对比
阅读完成 · 觉得有帮助？
