DocumentaciónKCS de Experience Cloud

Adobe Experience Manager: Se han corregido los vínculos de recursos y navegación rotos debido a la falta de asignaciones de rutas de Dispatcher

Última actualización: 24 de julio de 2026

En este artículo se explica cómo resolver los vínculos rotos de navegación y recursos en los sitios de Adobe Experience Manager (AEM) cuando las asignaciones de rutas de Dispatcher faltan o están incompletas después del mantenimiento o las actualizaciones de la caché de Dispatcher.

Descripción description

Entorno

Adobe Experience Manager Sites (AEM Sites), todas las versiones compatibles y los modelos de implementación mediante el módulo de Dispatcher

Síntomas

Después de realizar el mantenimiento programado o actualizar la caché de Dispatcher, los vínculos de navegación y las rutas de recursos de imagen en el sitio se rompen. Los vínculos afectados generan direcciones URL que comienzan por /content/<site-context>/... (que funcionan) o /<site-context>/... (que no funcionan). Antes del problema, ninguno de estos patrones de ruta aparecía en las rutas de vínculo. El problema también afecta a las rutas de imágenes, lo que da como resultado imágenes rotas en todo el sitio.

Causa

Una asignación de ruta de Dispatcher que falta o está incompleta para el contexto del sitio provoca que se generen direcciones URL que no se resuelven correctamente. Esta laguna de configuración a menudo se expone después de que Dispatcher borre la caché o realice actividades de mantenimiento, lo que provoca direcciones URL no asignadas y vínculos y recursos rotos.

Resolución resolution

Siga los pasos a continuación para resolver el problema:

  1. Revise los archivos de configuración de Dispatcher para ver si faltan asignaciones de ruta relacionadas con la ruta de contexto del sitio.

  2. Inspeccione los archivos de asignación (como aem-base-uris.txt o equivalente) para asegurarse de que todas las asignaciones necesarias están presentes en el contexto del sitio.

  3. Agregue una asignación de /<site-context> a /content/<site-context> en la configuración de Dispatcher. Por ejemplo:

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

  4. Si es necesario, configure un redireccionamiento de Dispatcher 301 a URL de vanidad canónicas para garantizar una resolución de URL coherente.

  5. Después de actualizar la configuración, borre la caché de Dispatcher para aplicar los cambios.

  6. Compruebe que los vínculos de navegación y las rutas de recursos de imagen ahora se resuelven correctamente en el sitio.

  7. Si los agentes de replicación se pausaron durante el mantenimiento, reanude su funcionamiento.

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