ACS Commons-Asset und MCP melden Fehler in AEM-Umgebungen

Letzte Aktualisierung: 22. Juni 2026

Die Generierung von ACS Commons-Berichten in Adobe Experience Manager (AEM) schlägt fehl, wenn Asset-Berichte, MCP-Berichte oder Report Builder-Dashboards Fehler, leere Downloads oder leere Ergebnisse zurückgeben. Dieses Problem tritt aufgrund veralteter ACS Commons-Versionen, fehlender Bundles oder falsch konfigurierter Berichtsdefinitionen auf, die die Berichtsausführung beeinträchtigen. Um das Problem zu beheben, aktualisieren Sie die Version, validieren Sie die Bundles und beheben Sie die Konfigurationen.

Beschreibung description

Umgebung

Adobe Experience Manager as a Cloud Service (AEMaaCS)

Problem/Symptome

Zeigt den Fehler an: java.lang.NoSuchMethodError: org.apache.poi.xssf.usermodel.XSSFColor.< init> (Ljava/awt/Color;)V während der Berichterstellung.
Zeigt TooManyCallsException während der Berichtsausführung oder gibt leere Berichtsergebnisse zurück.
Das ACS Commons-Report Builder-Dashboard konnte unter /apps/acs-commons/content/reports.html nicht geladen werden.
Fehler beim Herunterladen von MCP-generierten Berichtsdateien oder Zurückgeben leerer Excel-/CSV-Dateien.
Zu Fehlerseiten beim Zugriff auf Berichts-Dashboards oder Ausführungsendpunkte umleiten.

Grundursache

Das Problem tritt auf, wenn eine veraltete ACS Commons-Version inkompatible Apache-POI-APIs verwendet oder wenn erforderliche Report Builder-Bundles fehlen oder inaktiv sind. Falsch konfigurierte Berichtsdefinitionen, unvollständige Abhängigkeiten oder komplexe Abfragen, die Systembeschränkungen überschreiten, führen ebenfalls zu Fehlern wie NoSuchMethodError, leeren Ergebnissen oder Ausführungsausnahmen.

Lösung resolution

Führen Sie die folgenden Schritte aus, um den Fehlertyp zu identifizieren und das Problem mit dem ACS Commons-Bericht zu beheben:

Identifizieren Sie den Fehlertyp, indem Sie die AEM-Protokolle überprüfen und Fehler wie NoSuchMethodError, XSSFColor oder TooManyCallsException suchen.
Kategorisieren Sie das Problem, indem Sie den erkannten Fehler Szenarien wie Versionsinkompatibilität, fehlende Pakete, leere Ergebnisse oder Ausführungsbeschränkungen zuordnen.
Beheben Sie versionsbezogene Fehler, indem Sie ACS Commons auf Version 6.0.14 oder höher aktualisieren und das Update über die Cloud Manager-Pipeline bereitstellen.
Validieren Sie die Bundle-Bereitstellung, indem Sie das ACS Commons Report Builder-Bundle in /system/console/bundles überprüfen und sicherstellen, dass es ohne Abhängigkeitsprobleme aktiv ist.
Korrigieren Sie leere Berichtsergebnisse, indem Sie überprüfen, ob Assets in der Umgebung vorhanden sind, und überprüfen, ob die ausgewählten Berichtspfade und -konfigurationen korrekt sind.
Sie können Ausführungsbeschränkungen beheben, indem Sie ggf. den Schwellenwert für sling.max.calls erhöhen, um komplexe Berichtsabfragen zu verarbeiten.
Validieren Sie die Lösung, indem Sie den Bericht erneut ausführen, den erfolgreichen Download bestätigen, sicherstellen, dass das Dashboard korrekt geladen wird, und überprüfen, ob die Berichtsdaten wie erwartet angezeigt werden.

Wann eskalieren

Das Problem besteht nach dem Upgrade von ACS Commons und der Validierung der Bundle-Aktivierung weiterhin.
Die Berichterstellung schlägt trotz korrekter Konfiguration und Datenverfügbarkeit weiterhin fehl.
Die vordefinierten AEM Asset-Berichte können weder generiert noch heruntergeladen werden.
Der Fehler zeigt ein Problem auf Systemebene an, das über die ACS Commons-Konfiguration hinausgeht.