Jenkins部署AEM应用包时acs-commons子包安装失败求助

从你贴的Jenkins控制台错误来看，核心问题很明确：你尝试安装的acs-aem-commons-content:3.15.2依赖于day/cq60/product:cq-content:6.3.76，但这个cq-content包需要的一系列Adobe Granite核心内容包在你的AEM实例上缺失了，导致Vault拒绝安装。

M Starting installation of subpackage adobe/consulting:acs-aem-commons-content:3.15.2
FATAL: org.apache.jackrabbit.vault.packaging.DependencyException: Refusing to install package day/cq60/product:cq-content:6.3.76.
required dependencies missing: [adobe/granite:com.adobe.granite.ui.content:0.8.452, adobe/granite:com.adobe.granite.ui.legacy:0.1.34, adobe/granite:com.adobe.granite.ui.shared.content:1.1.18, adobe/granite:com.adobe.granite.platform.content:0.5.52, adobe/granite:com.adobe.granite.platform.welcome:1.1.12, adobe/granite:com.adobe.granite.platform.clientlibs:1.1.106, adobe/granite:com.adobe.granite.security.content:0.2.174, adobe/granite:com.adobe.granite.replication.content:1.0.30, adobe/granite:com.adobe.granite.monitoring.content:1.0.26, adobe/granite:com.adobe.granite.backup.content:0.0.62, adobe/granite:com.adobe.granite.cluster.content:0.0.40, adobe/granite:com.adobe.granite.activitystreams.content:0.0.22, adobe/granite:com.adobe.granite.workflow.content:1.0.48]
Build step 'Deploy Content Packages to CRX' changed build result to FAILURE

下面是几个可行的解决方向，按优先级排序：

1. 确认AEM实例是完整安装的 #

这些缺失的包都是AEM 6.3原生的核心内容包，正常情况下会随AEM安装程序自动部署。如果你的实例是自定义精简安装或者之前手动删除过核心包，就会出现这种依赖缺失。

解决办法：

• 重新使用官方AEM 6.3.76的安装程序部署一个全新实例，选择默认的完整安装选项，不要精简任何组件。
• 安装完成后，登录AEM的Package Manager（/crx/packmgr），检查所有adobe/granite开头的核心包是否都已存在且处于激活状态。

2. 手动安装缺失的依赖包 #

如果无法重新部署实例，可以手动下载并安装这些缺失的包：

• 登录Adobe软件分发门户，找到对应AEM 6.3.76版本的配套Granite内容包集合。
• 按顺序下载错误信息中列出的所有adobe/granite包（建议先安装platform相关，再安装ui、security、workflow等类别）。
• 通过AEM Package Manager逐一上传并安装这些包，确保每个包都安装成功后，再尝试重新部署ACS Commons。

3. 调整Jenkins部署流程的顺序 #

如果你的Jenkins部署流水线是先部署自定义子包（比如ACS Commons、核心组件），再部署AEM基础包，那顺序完全反了。正确的流程应该是：

• 第一步：部署完整的AEM基础环境（包括所有原生Granite和CQ内容包）。
• 第二步：验证基础包都安装成功后，再部署ACS Commons、核心组件等依赖子包。
• 检查Jenkins的Deploy Content Packages to CRX步骤配置，确保包的部署顺序符合依赖层级。

4. 检查ACS Commons版本兼容性 #

ACS Commons 3.15.2是针对AEM 6.3的稳定版本，但如果你的AEM实例版本不是6.3.76，可能会出现依赖不匹配。确认你的AEM实例版本和cq-content包版本完全对应，必要时可以升级或降级ACS Commons到匹配你AEM版本的版本。

内容的提问来源于stack exchange，提问作者Sri