DocumentazioneExperience Cloud KCS

Adobe Experience Manager: correzione dei collegamenti alle risorse e alla navigazione interrotti a causa di mappature del percorso del dispatcher mancanti

Ultimo aggiornamento: 24 luglio 2026

Questo articolo spiega come risolvere i collegamenti interrotti di navigazione e alle risorse nei siti di Adobe Experience Manager (AEM) quando le mappature dei percorsi del dispatcher risultano mancanti o incomplete dopo un aggiornamento della manutenzione o della cache del dispatcher.

Descrizione description

Ambiente

Adobe Experience Manager Sites (AEM Sites), tutte le versioni e i modelli di distribuzione supportati che utilizzano il modulo dispatcher

Sintomi

Dopo gli aggiornamenti pianificati della cache di manutenzione o dispatcher, i collegamenti di navigazione e i percorsi delle risorse immagine nel sito si interrompono. Gli URL di output dei collegamenti interessati iniziano con /content/<site-context>/... (che funziona) o /<site-context>/... (che non funziona). Prima del problema, nessuno di questi modelli di percorso veniva visualizzato nei percorsi di collegamento. Il problema influisce anche sui percorsi delle immagini, causando immagini interrotte in tutto il sito.

Causa

La mappatura mancante o incompleta del percorso del dispatcher per il contesto del sito causa la generazione di URL che non vengono risolti correttamente. Questo gap di configurazione viene spesso esposto dopo che la cache del dispatcher è stata cancellata o dopo le attività di manutenzione, causando URL non mappati e collegamenti e risorse interrotti.

Risoluzione resolution

Per risolvere il problema, segui i passaggi seguenti:

  1. Esamina i file di configurazione del dispatcher per individuare eventuali mappature di percorso mancanti in relazione al percorso contestuale del sito.

  2. Esaminare i file di mapping, ad esempio aem-base-uris.txt o equivalenti, per verificare che tutti i mapping richiesti siano presenti per il contesto del sito.

  3. Aggiungi un mapping da /<site-context> a /content/<site-context> nella configurazione del dispatcher. Ad esempio:

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

  4. Se necessario, configura un reindirizzamento di Dispatcher 301 agli URL personalizzati canonici per garantire una risoluzione coerente degli URL.

  5. Dopo aver aggiornato la configurazione, cancella la cache del dispatcher per applicare le modifiche.

  6. Verifica che i collegamenti di navigazione e i percorsi delle risorse immagine ora vengano risolti correttamente nel sito.

  7. Se gli agenti di replica sono stati messi in pausa durante la manutenzione, riprenderne l’operazione.

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