설명서Experience Cloud KCS

AEM 환경에서 ACS Commons 에셋 및 MCP 보고서 실패

마지막 업데이트: 2026년 6월 21일

Adobe Experience Manager(AEM) 자산 보고서, MCP 보고서 또는 Report Builder 대시보드가 오류, 빈 다운로드 또는 빈 결과를 반환하면 ACS Commons 보고서 생성에 실패합니다. 이 문제는 오래된 ACS Commons 버전, 번들 누락 또는 보고서 실행에 영향을 주는 잘못 구성된 보고서 정의로 인해 발생합니다. 이 문제를 해결하려면 버전을 업그레이드하고 번들의 유효성을 검사한 다음 구성을 수정하십시오.

설명 description

환경

Adobe Experience Manager as a Cloud Service (AEMaaCS)

문제/증상

  • 오류를 표시합니다. java.lang.NoSuchMethodError: org.apache.poi.xssf.usermodel.XSSFColor.< 보고서 생성 중 init>(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 번들이 없거나 비활성 상태인 경우 이 문제가 발생합니다. 잘못 구성된 보고서 정의, 불완전한 종속성 또는 시스템 제한을 초과하는 복잡한 쿼리는 NoSuchMethodError, 빈 결과 또는 실행 예외와 같은 오류도 초래합니다.

해결 방법 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