在AEM环境中安装包失败

当包中包含不可变路径、无效的ZIP结构、安装挂接或受影响的AEM版本时,SDK包安装失败。 诊断安装错误并按照相应的解决步骤成功安装软件包。

描述 description

环境

  • Adobe Experience Manager as a Cloud Service
  • AEM Managed Services
  • Adobe Developer App Builder

问题/症状

  • 上载期间出现错误,指示存档文件不是有效的内容包,因为缺少jcr_root。
  • 安装过程中出现包验证错误。
  • 安装被阻止,因为软件包包含不可变的存储库路径。
  • 所有包中嵌入的包不会自动安装。
  • 包名称无效导致包下载失败。
  • 与缺少安装挂接类相关的安装失败。

原因

当包结构无效、包包含不可变的存储库路径、包名称包含不支持的字符、在不支持的位置使用安装挂接,或者部署依赖于受回归影响的SDK版本时,会发生安装失败。

解决方法 resolution

要解决此问题,请执行以下步骤:

  1. 通过查看包管理器消息或日志来识别安装错误。
  2. 如果包无法识别为内容包,请验证ZIP文件顶层是否存在META-INFjcr_root。 如有必要,请重新创建包。
  3. 如果包包含不可变的存储库路径,请通过相应的部署管道部署代码,而不是直接通过包管理器进行安装。
  4. 如果嵌入的包未自动安装,请验证SDK版本,并升级到包含回归修复程序的SDK版本。
  5. 在部署到不支持安装挂接的环境时,请删除安装挂接。 对于支持的环境,请确保安装了所有必需的依赖项。
  6. 更新包名称以删除不支持的字符并重新构建包,然后再重新部署。
  7. 通过确认不再出现安装错误并在适用时正确安装嵌入包来验证安装。

相关阅读

recommendation-more-help
experience-cloud-kcs-help-kbarticles