DocumentazioneExperience Cloud KCS

Problemi di abbreviazione degli URL di AEM relativi alla rimozione delle estensioni e alle mappature Sling

Ultimo aggiornamento: 22 giugno 2026

La riduzione degli URL in AEM può non riuscire quando si tenta di rimuovere estensioni, nascondere percorsi interni o riscrivere segmenti. Per risolvere il problema, utilizza i meccanismi di riscrittura supportati, convalida le mappature e riconosce i vincoli della piattaforma.

Descrizione description

Ambiente

  • Adobe Experience Manager as a Cloud Service (AEMaaCS)
  • AEM Managed Services
  • AEM On-Premise (6.5 e versioni precedenti)

Problema/Sintomi

  • Gli URL brevi non si risolvono durante la pubblicazione ma funzionano in ambienti locali
  • L’estensione .html non è stata rimossa nelle implementazioni cloud
  • Gli URL con # frammenti non vengono mappati o riscritti
  • Le pipeline del rewriter si applicano a percorsi di contenuto non desiderati
  • Impossibile modificare i percorsi riservati come /experiments
  • model.json richieste duplicate si verificano nelle implementazioni SPA

Causa principale

I problemi di abbreviazione degli URL si verificano a causa di funzioni non supportate negli ambienti cloud, limitazioni HTTP con frammenti di URL, mappature Sling non configurate correttamente, configurazioni del rewriter sovrapposte e percorsi di sistema richiesti che non possono essere modificati.

Come confermare

  • Confrontare il comportamento tra ambienti locali e di pubblicazione
  • Esaminare le richieste di rete del browser per verificare la risoluzione degli URL
  • Verifica la presenza di più chiamate model.json nelle implementazioni SPA
  • Revisione dei registri per la mappatura o la riscrittura dell’esecuzione delle regole

Risoluzione resolution

Per risolvere il problema:

  1. Utilizzare le regole di riscrittura Dispatcher o CDN (ad esempio Apache mod_rewrite) per gestire la rimozione delle estensioni e la riduzione degli URL.
  2. Evita di tentare di mappare o riscrivere i frammenti di URL (#), in quanto non vengono elaborati sul lato server.
  3. Assicurati che le pipeline del rewriter abbiano valori di ordine univoci e ambiti di percorso distinti.
  4. Non modificare i percorsi riservati al sistema, ad esempio /experiments, in quanto sono necessari per caratteristiche specifiche del prodotto.
  5. Aggiorna le mappature Sling per garantire che gli URL brevi vengano risolti correttamente nei percorsi di contenuto interni, in particolare per le implementazioni SPA.
  6. Per le impostazioni on-premise, configura le regole di riscrittura a livello di server per supportare la rimozione delle estensioni.

Lettura correlata

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