Dokumentation

Startseite wird nicht mit Inhalten in Adobe Experience Manager geladen

Last update: Tue Oct 14 2025 00:00:00 GMT+0000 (Coordinated Universal Time)

AEM as a Cloud Service bedient gelegentlich eine leere Homepage, stört das Benutzererlebnis und löst falsche Ausfallzeitwarnungen aus. Dieses Problem wird häufig durch vorzeitiges Caching, nicht initialisierte Services oder Rendering-Fehler verursacht. In diesem Artikel wird erläutert, wie Sie dieses Problem beheben können, indem Sie Cache-Regeln anpassen, das Aufwärmverhalten überprüfen und Konsistenzprüfungen für benutzerdefinierte Komponenten hinzufügen, um eine zuverlässige Inhaltsbereitstellung sicherzustellen.

Beschreibung description

Umgebung

Dieses Problem betrifft Adobe Experience Manager (AEM) as a Cloud Service - Sites, insbesondere in der Produktionsumgebung.

Problem/Symptome

Die Homepage wird gelegentlich ohne Inhalt geladen, wodurch eine leere Seite bereitgestellt wird. Überwachungs-Tools generieren mehrere Warnhinweise, die auf Ausfälle der Startseite hinweisen. Obwohl sich das Problem innerhalb von 10-20 Minuten von selbst löst, tritt es häufig wieder auf. Während dieser Zeiträume zeigt die Analyse Diskrepanzen bei der Seitengröße an, und das System stellt zwischengespeicherte Versionen der leeren Seite bereit.

Auflösung resolution

Führen Sie zur Lösung dieses Problems folgende Schritte durch:

  1. Konfigurieren Sie geeignete Regeln für die Cache-Invalidierung, um zu verhindern, dass veraltete oder inkonsistente Inhalte bereitgestellt werden. localhost oder 127.0.0.1 als ServerAlias in die Konfiguration des virtuellen Hosts für die Dispatcher-Invalidierung einbeziehen. Weitere Informationen finden Sie unter Grundlagen zum Caching in Dispatcher und Ungültige zwischengespeicherte Seiten aus AEM.

  2. Deaktivieren Sie vorübergehend den Aufwärm-Service, wenn Anforderungen gesendet werden, bevor alle Services initialisiert werden. Dies kann dazu führen, dass unvollständige Seiten zwischengespeichert werden.

  3. Führen Sie ein Upgrade auf die neueste Version von AEM durch, um Fehlerbehebungen anzuwenden, die Probleme beheben, bei denen Rendering-Fehler zu zwischengespeicherten Nullwerten führen.

  4. Überprüfen und aktualisieren Sie Sling-Modelle in Ihrer Code-Basis (weitere Informationen finden Sie unter Erstellen eines Sling-Modells für die Komponente):

    • Markieren Sie Injektionen nur dann als optional, wenn dies erforderlich ist.
    • Verarbeiten Sie Nullwerte im Code explizit, um Laufzeitausnahmen während der Initialisierung zu vermeiden.

  5. Implementieren Sie OSGi-Konsistenzprüfungen für kritische benutzerdefinierte Komponenten, um sicherzustellen, dass diese vor der Bereitstellung von Traffic initialisiert werden:

    code language-none 
    {
    "hc.name": "Required Custom Components",
    "hc.tags": [ "systemalive", "systemready"] ,
    "components.list": [ "com.example.core.services.impl.RenditionServiceImpl"]
}

    Testen Sie diese Konfiguration lokal, indem Sie auf /system/console/healthcheck?tags=systemready zugreifen und bestätigen, dass alle aufgelisteten Komponenten den Status "". Weitere Informationen finden Sie unter ​ von OSGi für AEM as a Cloud Service.

  6. Überprüfen Sie die Pod-Protokolle beim Start, um Ausnahmen im Zusammenhang mit Rendering-Fehlern oder nicht initialisierten Services (z. B. NullPointerException) zu identifizieren. Beheben Sie diese Probleme, indem Sie eine ordnungsgemäße Injektion und Initialisierung von Abhängigkeiten sicherstellen.

  7. Testen Sie alle Änderungen in Staging-Umgebungen, bevor Sie sie in der Produktion bereitstellen, um das Risiko von Ausfallzeiten oder Caching-Problemen zu reduzieren.

Mit diesen Schritten können Sie wiederkehrende Ausfälle der Startseite verhindern und eine konsistente Inhaltsbereitstellung sicherstellen, indem Sie die Grundursachen wie Service-Initialisierungsfehler und Caching-Fehlkonfigurationen beheben.

recommendation-more-help
3d58f420-19b5-47a0-a122-5c9dab55ec7f