文档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日志并查找错误（如​NoSuchMethodError、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