【HarmonyOS NEXT】error: failed to install bundle. code:9568322...

🎯 核心原因一：手动签名配置了发布证书（Release Profile）

这是最常见的原因之一。发布证书签名的应用，无法直接通过hdc命令安装到真机进行调试。

• 现象：你按照文档配置了生产环境的Profile，设备也添加了，但依然报错。

• 根本原因：发布证书包只能用于提交到应用市场，或通过市场公开测试渠道分发。用于本地调试，必须使用调试证书（Debug Certificate）。

• 解决方案：在DevEco Studio中，切换到调试签名配置。

  • 检查build-profile.json5中signingConfig是否误写为"release"。

  • 在IDE编辑器的右上角，确认Build Mode是否选为Debug，SigningConfig是否为default（代表调试）。

🎯 核心原因二：设备UDID未添加到Profile文件

鸿蒙系统加强了对签名的校验，应用安装时会校验签名中的UDID列表是否包含当前真机。

• 现象：自动签名失败，或手动签名时提示“not trusted app source”。

• 解决方案：

  1. 自动签名：确保真机已通过USB连接电脑，并在DevEco Studio中重新执行一次自动签名（点击Sign In登录后，再点击签名图标），IDE会自动将当前设备的UDID写入新的Profile文件。

  2. 手动签名：你需要登录AppGallery Connect，在“证书、APP ID和Profile”页面，编辑或重新生成Profile文件，在设备列表中添加当前测试机的UDID，然后下载新的.p7b文件并替换到项目中。

获取UDID命令：hdc shell bm get -u。

🎯 核心原因三：证书与Profile文件不匹配

手动签名时，配置的.cer（证书）文件与.p7b（Profile）文件不匹配，或者keyAlias配置错误。

• 解决方案：

  1. 在AppGallery Connect中，确认你当前使用的Profile文件，其“归属证书”是否就是你配置的.cer文件。

  2. 检查IDE签名配置中的keyAlias，必须与申请Profile时使用的证书别名一致。

✅ 终极解决路径：快速自查清单

建议按照以下顺序快速排查：

1. 【最推荐】清空签名，重新自动签名：删除项目build-profile.json5中的signingConfig相关配置，确保设备连接，点击自动签名，然后Clean Project后重新运行。

2. 检查构建模式：确保Product->Build Mode当前选中的是Debug，而非Release。

3. 核对证书类型：在手动签名界面，确认选中的是调试证书和调试Profile，文件名的描述信息中通常会有“debug”字样。

如果以上步骤都排查过仍未解决，建议尝试删除项目根目录下的build文件夹，并执行File->Invalidate Caches / Restart...清理IDE缓存后重试。