ACS Commons功能在Adobe Experience Manager中不可用

最近更新： 2026年8月8日

在Adobe Experience Manager中，ACS AEM Commons模块可能缺失，BPA报表中可能会显示不支持的API查找结果，或者版本兼容性问题可能会妨碍功能正常工作。未部署ACS Commons、使用不支持的API或在不兼容的版本上运行时，会出现这些问题。要修复此问题，请识别问题类型，部署正确的ACS Commons包，更新不支持的API，并验证兼容性要求。

描述 description

环境

Adobe Experience Manager as a Cloud Service (AEMaaCS)

问题/症状

AEM UI中缺少ACS Commons模块，例如报表、内容同步或MCP控制台。
/var/acs-commons/reports或相关文件夹无法部署到AEMaaCS。
BPA输出显示不支持的API查找结果，如{“type”：“unsupported.asset.api”，“told”：“com.day.cq.dam.api.AssetManager.createAsset”}。
BPA报告标记不支持的ACS Commons类，如com.adobe.acs.commons.mcp.impl.processes.asset.AssetIngestor。
包管理器搜索栏不显示ACS Commons包。

解决方法 resolution

要解决此问题，请执行以下步骤：

查看BPA输出或模块行为，并将问题分类为缺少模块、版本不兼容、不支持的API或部署过滤器问题。
确认类别与观察到的症状相匹配，例如缺少UI元素、BPA错误或部署失败。
导航到/system/console/bundles并搜索acs。
验证捆绑包是否处于“活动”状态。
将ACS Commons依赖项添加到您的Maven项目并使用Cloud Service所需的云分类器
确保cloud分类器按照Adobe API删除指南的要求用于AEMaaCS
通过Cloud Manager部署更新的ACS Commons版本。
部署后重新访问/system/console/bundles，并确认ACS Commons捆绑包处于活动状态。
如果部署失败，请验证Git存储库中存在ACS文件夹。
从ACS Commons Releases下载ACS Commons包并将其上载到/crx/packmgr。
验证软件包是否安装成功。
验证捆绑包是否处于“活动”状态。
如果安装失败，请查阅ACS Commons兼容性矩阵。
验证部署代码中是否存在所需的ACS Commons模块。
在AEMaaCS中，查看ui.content/src/main/content/jcr_root下的Git存储库。
确认/var/acs-commons/reports包含在filter.xml中。
查看CRX/DE以了解路径可见性。
如果模块仍然不可用，请确认Git分支包含所需的文件夹。
识别已弃用的API用法，如com.day.cq.dam.api.AssetManager.createAsset或com.adobe.acs.commons.mcp.impl.processes.asset.AssetIngestor。
验证是否不再显示unsupported.asset.api调查结果。
如果调查结果持续存在，请通过GitHub向ACS Commons维护者记录问题。
对于AEMaaCS部署，请确保没有模块尝试将运行时写入/apps或/libs，因为Cloud Service不支持这些路径。
验证所有ACS Commons代码是否通过Cloud Manager管道成功部署。
查看管道日志，并确认部署已成功完成。
如果出现部署问题，请查看filter.xml并删除任何被禁止的路径。

ACS Commons功能在Adobe Experience Manager中不可用

描述 description

环境

问题/症状

解决方法 resolution

相关阅读