DocumentationExperience Cloud KCS

Problèmes de raccourcissement des URL d’AEM avec la suppression des extensions et les mappages Sling

Dernière mise à jour : 23 juin 2026

Le raccourcissement des URL dans AEM peut échouer lors de la tentative de suppression d’extensions, de masquage de chemins internes ou de réécriture de segments. Pour résoudre ce problème, utilisez les mécanismes de réécriture pris en charge, validez les mappages et reconnaissez les contraintes de la plateforme.

Description description

Environnement

  • Adobe Experience Manager as a Cloud Service (AEMaaCS)
  • AEM Managed Services
  • AEM On-Premise (6.5 et versions antérieures)

Problème/Symptômes

  • Les URL courtes ne sont pas résolues lors de la publication, mais fonctionnent dans les environnements locaux
  • .html extension n’est pas supprimée sur les déploiements cloud
  • Les URL contenant # fragments ne sont pas mappées ni réécrites
  • Les pipelines de réécriture s’appliquent aux chemins de contenu involontaires
  • Les chemins réservés tels que /experiments ne peuvent pas être modifiés
  • Les requêtes model.json en double se produisent dans les implémentations de SPA.

Cause principale

Des problèmes de raccourcissement des URL se produisent en raison de fonctionnalités non prises en charge dans les environnements cloud, de limitations HTTP avec des fragments d’URL, de mappages Sling mal configurés, de configurations de réécriture qui se chevauchent et de chemins système requis qui ne peuvent pas être modifiés.

Comment confirmer

  • Comparer le comportement entre les environnements local et de publication
  • Inspecter les requêtes réseau du navigateur pour vérifier la résolution de l’URL
  • Rechercher plusieurs appels model.json dans les implémentations de SPA
  • Consulter les journaux pour l’exécution du mappage ou de la règle de réécriture

Résolution resolution

Pour résoudre le problème :

  1. Utilisez des règles de réécriture Dispatcher ou CDN (telles qu’Apache mod_rewrite) pour gérer la suppression des extensions et le raccourcissement des URL.
  2. Évitez de tenter de mapper ou de réécrire des fragments d’URL (#), car ils ne sont pas traités côté serveur.
  3. Assurez-vous que les pipelines de réécriture ont des valeurs d’ordre uniques et des portées de chemin distinctes.
  4. Ne modifiez pas les chemins réservés au système tels que /experiments, car ils sont requis pour des fonctionnalités de produit spécifiques.
  5. Mettez à jour les mappages Sling pour vous assurer que les URL courtes se résolvent correctement sur des chemins de contenu internes, en particulier pour les implémentations de SPA.
  6. Pour les configurations on-premise, configurez des règles de réécriture au niveau du serveur pour prendre en charge la suppression des extensions.

Lecture connexe

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