ACS Commons功能在Adobe Experience Manager中無法使用

最後更新： 2026年8月8日

在Adobe Experience Manager中，ACS AEM Commons模組可能遺失，不支援的API發現可能出現在BPA報告中，或是版本相容性問題導致功能無法正常運作。未部署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”，“telled”：“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套件組合作用中。
如果部署失敗，請驗證ACS資料夾存在於Git存放庫中。
從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

相關閱讀