文件Experience Cloud KCS

AEM環境中的ACS Commons資產和MCP報告失敗

最後更新： 2026年6月22日

當資產報告、MCP報告或Report Builder儀表板傳回錯誤、空白下載或空白結果時，Adobe Experience Manager (AEM) ACS Commons報告產生失敗。 此問題是由於ACS Commons版本過時、缺少套件組合或影響報告執行的報告定義設定錯誤所導致。 若要解決此問題，請升級版本、驗證套件組合併修正設定。

說明 description

環境

Adobe Experience Manager as a Cloud Service (AEMaaCS)

問題/症狀

  • 顯示錯誤： java.lang.NoSuchMethodError： org.apache.poi.xssf.usermodel.XSSFColor.< 在報告產生期間初始化> (Ljava/awt/Color；)V。
  • 在報告執行期間顯示​ TooManyCallsException ​或傳回空白報告結果。
  • 無法於/apps/acs-commons/content/reports.html載入ACS Commons Report Builder儀表板。
  • 無法下載MCP產生的報表檔案，或傳回空白的Excel/CSV檔案。
  • 重新導向至存取報告儀表板或執行端點時的錯誤頁面。

根本原因

當過期的ACS Commons版本使用不相容的Apache POI API，或當必要的Report Builder套件組合遺失或非使用中時，就會發生問題。 設定錯誤的報表定義、不完整的相依性，或超過系統限制的複雜查詢，也會導致NoThocMethodError、空白結果或執行例外等失敗。

解決方法 resolution

按照以下步驟識別失敗型別並解決ACS Commons報告問題：

  1. 請檢閱AEM記錄檔並找出錯誤，例如​NoThocMethodError、XSSFColor​或​TooManyCallsException，以識別失敗型別。
  2. 將偵測到的錯誤對應到版本不相容性、缺少套件組合、空白結果或執行限制等情況，將問題分類。
  3. 將ACS Commons升級至6.0.14版或更新版本，並透過Cloud Manager管道部署更新，以解決與版本相關的錯誤。
  4. 檢查/system/console/bundles中的ACS Commons Report Builder套件組合併確保其作用中且沒有相依性問題，以驗證套件組合部署。
  5. 透過驗證資產存在於環境中並確認所選報表路徑和設定正確來修正空白報表結果。
  6. 在適用的情況下，提高sling.max.calls臨界值以解決執行限制問題，以處理複雜的報表查詢。
  7. 重新執行報表、確認下載成功、確保控制面板正確載入，並驗證報表資料是否如預期顯示，以驗證解析度。

何時上報

  • 升級ACS Commons並驗證套件組合啟用後，問題仍然存在。
  • 儘管設定正確且資料可用性良好，報表產生仍持續失敗。
  • 無法產生或下載現成可用的AEM資產報表。
  • 此錯誤表示ACS Commons設定以外的系統層級問題。

相關閱讀

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