【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是否选为DebugSigningConfig是否为default代表调试。 核心原因二设备UDID未添加到Profile文件鸿蒙系统加强了对签名的校验应用安装时会校验签名中的UDID列表是否包含当前真机。现象自动签名失败或手动签名时提示“not trusted app source”。解决方案自动签名确保真机已通过USB连接电脑并在DevEco Studio中重新执行一次自动签名点击Sign In登录后再点击签名图标IDE会自动将当前设备的UDID写入新的Profile文件。手动签名你需要登录AppGallery Connect在“证书、APP ID和Profile”页面编辑或重新生成Profile文件在设备列表中添加当前测试机的UDID然后下载新的.p7b文件并替换到项目中。获取UDID命令hdc shell bm get -u。 核心原因三证书与Profile文件不匹配手动签名时配置的.cer证书文件与.p7bProfile文件不匹配或者keyAlias配置错误。解决方案在AppGallery Connect中确认你当前使用的Profile文件其“归属证书”是否就是你配置的.cer文件。检查IDE签名配置中的keyAlias必须与申请Profile时使用的证书别名一致。✅ 终极解决路径快速自查清单建议按照以下顺序快速排查【最推荐】清空签名重新自动签名删除项目build-profile.json5中的signingConfig相关配置确保设备连接点击自动签名然后Clean Project后重新运行。检查构建模式确保Product-Build Mode当前选中的是Debug而非Release。核对证书类型在手动签名界面确认选中的是调试证书和调试Profile文件名的描述信息中通常会有“debug”字样。如果以上步骤都排查过仍未解决建议尝试删除项目根目录下的build文件夹并执行File-Invalidate Caches / Restart...清理IDE缓存后重试。