DokumentationExperience Cloud KCS

AEM URL-Verkürzungsprobleme beim Entfernen von Erweiterungen und Sling-Zuordnungen

Letzte Aktualisierung: 22. Juni 2026

Die URL-Verkürzung in AEM kann fehlschlagen, wenn versucht wird, Erweiterungen zu entfernen, interne Pfade auszublenden oder Segmente neu zu schreiben. Um das Problem zu beheben, verwenden Sie unterstützte Rewrite-Mechanismen, validieren Sie Zuordnungen und bestätigen Sie die Plattformeinschränkungen.

Beschreibung description

Umgebung

  • Adobe Experience Manager as a Cloud Service (AEMaaCS)
  • AEM Managed Services
  • AEM On-Premise (6.5 und früher)

Problem/Symptome

  • Kurze URLs werden bei der Veröffentlichung nicht aufgelöst, funktionieren jedoch in lokalen Umgebungen
  • .html Erweiterung wird in Cloud-Bereitstellungen nicht entfernt
  • URLs mit # Fragmenten werden nicht zugeordnet oder neu geschrieben
  • Rewriter-Pipelines gelten für unbeabsichtigte Inhaltspfade
  • Reservierte Pfade wie /experiments können nicht geändert werden
  • In SPA-Implementierungen treten doppelte model.json auf

Ursache

Probleme mit der URL-Verkürzung treten aufgrund nicht unterstützter Funktionen in Cloud-Umgebungen, HTTP-Einschränkungen mit URL-Fragmenten, falsch konfigurierter Sling-Zuordnungen, sich überschneidender Rewriter-Konfigurationen und erforderlicher Systempfade auf, die nicht geändert werden können.

Wie kann ich bestätigen

  • Verhalten zwischen lokaler und Veröffentlichungsumgebung vergleichen
  • Prüfen von Browser-Netzwerkanfragen, um die URL-Auflösung zu überprüfen
  • Prüfen auf mehrere model.json-Aufrufe in SPA-Implementierungen
  • Überprüfen von Protokollen für die Ausführung von Zuordnungs- oder Neuschreibungsregeln

Lösung resolution

Beheben des Problems:

  1. Verwenden Sie Dispatcher- oder CDN-Rewrite-Regeln (wie Apache mod_rewrite), um das Entfernen von Erweiterungen und die URL-Verkürzung zu handhaben.
  2. Versuchen Sie nicht, URL-Fragmente (#) zuzuordnen oder neu zu schreiben, da sie nicht Server-seitig verarbeitet werden.
  3. Stellen Sie sicher, dass Rewriter-Pipelines eindeutige Reihenfolgenwerte und unterschiedliche Pfadbereiche haben.
  4. Ändern Sie keine systemreservierten Pfade wie /experiments, da sie für bestimmte Produktfunktionen erforderlich sind.
  5. Aktualisieren Sie Sling-Zuordnungen , um sicherzustellen, dass kurze URLs korrekt in interne Inhaltspfade aufgelöst werden, insbesondere für SPA-Implementierungen.
  6. Konfigurieren Sie bei On-Premise-Setups Neuschreibungsregeln auf Serverebene, um das Entfernen von Erweiterungen zu unterstützen.

Verwandtes Lesen

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