Unterschiede bei der Fehlerbehandlung im Autorenmodus in AEM Sites-Umgebungen

Letzte Aktualisierung: 10. September 2026

Wenn im Autorenmodus in einer AEM Sites-Umgebung Inline-Komponentenfehler angezeigt werden, die Seite jedoch in einer anderen nicht gerendert werden kann, überprüfen Sie die WCMDeveloperModeFilter für jede Umgebung. Dieser Filter ist standardmäßig für jede Autoreninstanz aktiviert und für jede Veröffentlichungsinstanz standardmäßig deaktiviert. Unterschiede zwischen den Autorenebenen ergeben sich in der Regel aus der benutzerdefinierten Konfiguration und nicht aus den Platform-Standardwerten.

Beschreibung description

In Adobe Experience Manager Sites kann dieselbe Seite in verschiedenen Umgebungen unterschiedliche Verhaltensweisen bei der Fehlerbehandlung im Autorenmodus anzeigen. In einigen Autoreninstanzen werden Fehler auf Komponentenebene inline angezeigt und der Rest der Seite wird weiterhin gerendert. Bei anderen können ähnliche Fehler dazu führen, dass die gesamte Seite nicht gerendert wird oder nicht mehr bearbeitbar ist, obwohl die Code-Basis identisch ist.

Umgebung

Adobe Experience Manager as a Cloud Service (alle Versionen)

Problem/Symptome

Auf einer Autoreninstanz werden Komponentenfehler inline angezeigt und die Seite wird weiterhin geladen.
In einer anderen Autoreninstanz führt derselbe zugrunde liegende Fehler dazu, dass die Seite im Autorenmodus vollständig fehlschlägt.
Die Ursache dafür ist häufig ein fehlender Komponentenklassenverweis, der in jeder Umgebung eine Ausnahme auslöst, aber das daraus resultierende Benutzererlebnis unterscheidet sich.

Ursache

Dieser Unterschied ergibt sich aus der Konfiguration von WCMDeveloperModeFilter (auch als CQ WCM Debug-Filter bezeichnet). Standardmäßig aktiviert AEM diesen Filter für jede Autoreninstanz und deaktiviert ihn für jede Veröffentlichungsinstanz, unabhängig von der Umgebungsebene. Wenn dieser Filter aktiviert ist, erfasst er Komponentenausnahmen und rendert die Seite mit Inline-Fehlermeldungen. Wenn diese Option deaktiviert ist, kann eine Komponentenausnahme dazu führen, dass die gesamte Seite fehlschlägt.

Wenn sich dieser Filter zwischen Autorenumgebungen verschiedener Ebenen (z. B. Entwicklungs- vs. Staging- oder Produktionsautor) unterschiedlich verhält, prüfen Sie auf eine stufen-spezifische OSGi-Konfiguration, z. B. einen config.author.stage oder config.author.prod Ordner, der den Standard für diese Ebene explizit überschreibt. Dies ist eine Anpassung auf Projektebene, kein vorkonfiguriertes AEM-Verhalten.

Lösung resolution

Führen Sie diese Schritte aus, um das Problem zu beheben.

Überprüfen Sie, wie sich WCMDeveloperModeFilter standardmäßig verhält: Er ist in jeder Autoreninstanz aktiviert, wo er Komponentenausnahmen abfängt und Inline-Fehlermeldungen anzeigt, sodass der Rest der Seite gerendert wird, und ist in jeder Veröffentlichungsinstanz deaktiviert, wo eine Komponentenausnahme dazu führen kann, dass die gesamte Seite fehlschlägt.
Lassen Sie den Entwicklermodus in Autoreninstanzen aktiviert, damit Komponentenfehler frühzeitig angezeigt und behoben werden. Durch Deaktivieren kann es passieren, dass Fehler auf Komponentenebene ausgeblendet werden, bis der Code ein späteres Stadium erreicht.
Überprüfen Sie die Entwicklermoduskonfiguration für die betreffende Umgebung, indem Sie die OSGi-Konfiguration für com.day.cq.wcm.core.impl.WCMDeveloperModeFilter überprüfen, normalerweise in com.day.cq.wcm.core.impl.WCMDeveloperModeFilter.cfg.json, einschließlich aller stufenspezifischen Ausführungsmodusordner wie config.author.stage oder config.author.prod. Wenn die enabled-Eigenschaft auf false festgelegt ist, ist der Filter für diesen Bereich deaktiviert und wenn die Datei fehlt oder enabled nicht auf false festgelegt ist, verwendet der Filter den AEM-Standard.
Verwenden Sie die Fehler im seitlichen Bedienfeld des AEM-Editors, um Probleme auf Komponentenebene anzuzeigen. Nur Mitglieder der Administratorgruppe können auf den Entwicklermodus zugreifen.
Es empfiehlt sich, Komponentenfehler in einer Entwicklungs- oder Autorenumgebung einer niedrigeren Ebene zu beheben, bevor Sie Code hochstufen, damit dieselben Fehler nicht unerwartet auf einer Autoreninstanz einer höheren Ebene angezeigt werden.

Nachdem Sie eine Konfigurationsänderung vorgenommen haben, testen Sie eine Seite mit einem bekannten Komponentenfehler in jeder betroffenen Autorenumgebung, um das erwartete Verhalten bei der Fehlerbehandlung zu bestätigen.