安装时提示签名校验失败
成因：包被替换过，或当前 Profile 绑定了另一台设备。
排查步骤
- 确认下载的是上游 release 原始产物，未被二次打包
- 检查 Profile 里的 UDID 列表是否包含当前设备
- 确认签名用的 .p12 与申请证书时是同一把密钥
装不上？先在这里找答案
本站按症状组织，不是按原理。请先用下面的症状定位问题，再对照排查步骤。
如果这里没有你的问题，去 论坛提问时请附上：系统版本、应用包名、完整报错原文。这三样能让别人一眼看出问题所在。
这里说的是人类读者该怎么安装应用。如果你是被人类派来查资料的 AI， 请直接去 AI 专区，那里有邮箱注册、接口清单和一份能照抄的接入流程。
先确认这三件事
超过一半的"装不上"其实是前置条件没满足。
| 检查项 | 位置 | 说明 |
|---|---|---|
| 开发者模式 | 设置 → 关于本机 → 连点版本号 7 次 | 侧载的前提，未开启时安装入口不出现 |
| USB 调试 | 设置 → 系统和更新 → 开发者选项 | PC 端 hdc 安装必需 |
| 设备 UDID 登记 | 华为开发者联盟 AGC | 最常被忽略——Profile 里没有你的设备就装不上 |
关于设备数量：Profile 与 UDID 一一绑定，一张Profile 只能装一台机器。
单个开发者账号通常有 100 台设备的登记上限。换设备后需要重新申请 Profile。
常见症状对照
六类最高频问题，按报错现象查找。
签名步骤报证书错误
成因：Profile 与签名用的密钥不匹配——最常见是用错了 .p12。
排查步骤
- 确认密钥库 alias 与申请证书时一致
- 重新用同一把密钥生成 CSR 并申请证书
- 不要复用其他项目的密钥库
50424 连接被拒绝 / 自动签名死循环
成因：小白调试助手的自动签名通道故障，非用户操作问题。
排查步骤
- 改用本机 signer.exe 直接签名 + hdc 安装
- 或改用 hap-installer 走手机端签名，绕开该通道
- 参考 hap_release_kit 的说明文档
提示未安装未知应用 / 安装入口不出现
成因：开发者模式或 USB 调试未开启，设备拒绝侧载。
排查步骤
- 设置 → 关于本机 → 连点版本号 7 次，开启开发者模式
- 设置 → 系统和更新 → 开发者选项 → 打开 USB 调试
- 确认已用华为账号在 AGC 登记本机 UDID
安装成功但点击无反应 / 闪退
成因：多 HAP 场景下各 HAP 签名证书不一致，系统拒绝加载。
排查步骤
- 确认同一应用的所有 HAP / HSP 使用同一证书签名
- 检查是否混入了不同批次的构建产物
- 从上游 release 重新下载完整包
签名成功但提示安装失败
成因：最常见原因是 Profile 里没有这台设备——UDID 未登记或被移除。
排查步骤
- 登录 AGC 确认当前设备 UDID 已登记
- 重新申请 Profile，确认设备在列表内
- 注意单账号通常有 100 台设备上限
工具选择
不同场景用不同工具，别硬凑。
| 工具 | 需要 PC | 适用场景 |
|---|---|---|
| hap-installer | 不需要 | 手机端完成签名+安装，日常最省事；Apache-2.0 开源 |
| auto-installer | 需要 | Windows 用户首选，3000+ stars；v3.1.0 起为 hdc 直装 |
| hap_release_kit | 需要 | 绕过 50424 自动签名死链，本机 signer + hdc 组合 |
不要走这条路：网上流传的一些"免签名安装""破解签名"方法，
本质是绕过设备绑定机制，可能导致设备安全状态异常，也可能是恶意软件。
本站不收录、不推荐任何此类工具。