DocumentationExperience Cloud KCS

Adobe Experience Manager : correction de liens de navigation et de ressources rompus en raison de mappages de chemin du Dispatcher manquants

Dernière mise à jour : 24 juillet 2026

Cet article explique comment résoudre les liens de navigation et de ressources rompus dans les sites Adobe Experience Manager (AEM) lorsque les mappages de chemin du Dispatcher sont manquants ou incomplets après la maintenance ou les actualisations du cache du Dispatcher.

Description description

Environnement

Adobe Experience Manager Sites (AEM Sites), toutes les versions et tous les modèles de déploiement pris en charge à l’aide du module dispatcher

Symptômes

Une fois la maintenance planifiée ou les actualisations du cache du Dispatcher effectuées, les liens de navigation et les chemins d’accès aux ressources d’image du site sont rompus. Les liens affectés génèrent des URL commençant par /content/<site-context>/... (qui fonctionnent) ou /<site-context>/... (qui ne fonctionnent pas). Avant le problème, aucun de ces modèles de chemin n’apparaissait dans les chemins de lien. Le problème affecte également les chemins d’accès aux images, provoquant des images rompues sur l’ensemble du site.

Cause

Un mappage de chemin du Dispatcher manquant ou incomplet pour le contexte du site entraîne la génération d’URL qui ne sont pas résolues correctement. Cet écart de configuration est souvent exposé après l’effacement du cache du Dispatcher ou les activités de maintenance, ce qui entraîne des URL non mappées et des liens et des ressources rompus.

Résolution resolution

Suivez les étapes ci-dessous pour résoudre le problème :

  1. Vérifiez les fichiers de configuration du Dispatcher pour identifier les mappages de chemin manquants liés au chemin d’accès au contexte de votre site.

  2. Inspectez les fichiers de mappage (tels que aem-base-uris.txt ou équivalents) pour vous assurer que tous les mappages requis sont présents pour le contexte de votre site.

  3. Ajoutez un mappage de /<site-context> à /content/<site-context> dans la configuration du Dispatcher. Par exemple :

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

  4. Si nécessaire, configurez une redirection Dispatcher 301 vers les URL de redirection canoniques afin d’assurer une résolution d’URL cohérente.

  5. Après la mise à jour de la configuration, effacez le cache du Dispatcher pour appliquer les modifications.

  6. Vérifiez que les liens de navigation et les chemins d’accès aux ressources d’image sont désormais correctement résolus sur le site.

  7. Si les agents de réplication ont été suspendus pendant la maintenance, reprenez leur fonctionnement.

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