DokumentationExperience Cloud KCS

Adobe Experience Manager: Beheben von Navigationsfehlern und Asset-Links aufgrund fehlender Dispatcher-Pfadzuordnungen

Letzte Aktualisierung: 24. Juli 2026

In diesem Artikel wird erläutert, wie fehlerhafte Navigations- und Asset-Links in Adobe Experience Manager (AEM)-Sites aufgelöst werden können, wenn Dispatcher-Pfadzuordnungen fehlen oder nach Wartungs- oder Dispatcher-Cache-Aktualisierungen unvollständig sind.

Beschreibung description

Umgebung

Adobe Experience Manager Sites (AEM Sites), alle unterstützten Versionen und Bereitstellungsmodelle, die das Dispatcher-Modul verwenden

Symptome

Nach der geplanten Wartung oder Aktualisierung des Dispatcher-Caches sind die Navigations-Links und Bild-Asset-Pfade auf der Site beschädigt. Betroffene Links geben URLs aus, die entweder mit /content/<site-context>/... (welche funktionieren) oder mit /<site-context>/... (welche nicht funktionieren) beginnen. Vor dem Problem traten keines dieser Pfadmuster in Link-Pfaden auf. Das Problem wirkt sich auch auf Bildpfade aus, was zu beschädigten Bildern auf der gesamten Site führt.

Ursache

Eine fehlende oder unvollständige Dispatcher-Pfadzuordnung für den Site-Kontext führt dazu, dass URLs generiert werden, die nicht korrekt aufgelöst werden. Diese Konfigurationslücke wird häufig angezeigt, nachdem der Dispatcher-Cache oder Wartungsaktivitäten gelöscht wurde, was zu nicht zugeordneten URLs und fehlerhaften Links und Assets führt.

Lösung resolution

Gehen Sie wie folgt vor, um das Problem zu beheben:

  1. Überprüfen Sie Ihre Dispatcher-Konfigurationsdateien auf fehlende Pfadzuordnungen, die sich auf den Kontextpfad Ihrer Site beziehen.

  2. Überprüfen Sie Zuordnungsdateien (z. B. aem-base-uris.txt oder Ähnliches), um sicherzustellen, dass alle erforderlichen Zuordnungen für Ihren Site-Kontext vorhanden sind.

  3. Fügen Sie in der Dispatcher-Konfiguration eine Zuordnung von /<site-context> zu /content/<site-context> hinzu. Beispiel:

    /<site-context> /content/<site-context>

  4. Konfigurieren Sie bei Bedarf eine Dispatcher 301-Umleitung zu kanonischen Vanity-URLs, um eine konsistente URL-Auflösung sicherzustellen.

  5. Löschen Sie nach dem Aktualisieren der Konfiguration den Dispatcher-Cache, um die Änderungen anzuwenden.

  6. Stellen Sie sicher, dass Navigationslinks und Bild-Asset-Pfade jetzt auf der gesamten Site korrekt aufgelöst werden.

  7. Wenn Replikationsagenten während der Wartung angehalten wurden, setzen Sie den Betrieb fort.

recommendation-more-help
experience-cloud-kcs-help-kbarticles