DocumentaciónKCS de Experience Cloud

Problemas de acortamiento de la URL de AEM con la eliminación de extensiones y asignaciones de Sling

Última actualización: 22 de junio de 2026

El acortamiento de URL en AEM puede fallar al intentar eliminar extensiones, ocultar rutas internas o reescribir segmentos. Para solucionar el problema, utilice mecanismos de reescritura admitidos, valide asignaciones y reconozca restricciones de la plataforma.

Descripción description

Entorno

  • Adobe Experience Manager as a Cloud Service (AEMaaCS)
  • AEM Managed Services
  • AEM On-Premise (6.5 y versiones anteriores)

Problema/Síntomas

  • Las URL cortas no se resuelven en la publicación, sino que funcionan en entornos locales
  • La extensión .html no se ha eliminado en las implementaciones de la nube
  • Las direcciones URL con # fragmentos no se asignan ni se vuelven a escribir
  • Las canalizaciones de reescritura se aplican a rutas de contenido no deseadas
  • No se pueden modificar las rutas reservadas como /experiments
  • Las solicitudes duplicadas model.json se producen en implementaciones de SPA

Causa raíz

Los problemas de acortamiento de la URL se producen debido a funciones no admitidas en los entornos de la nube, limitaciones HTTP con fragmentos de URL, asignaciones de Sling mal configuradas, configuraciones de reescritura superpuestas y rutas de sistema requeridas que no se pueden modificar.

Cómo confirmar

  • Comparar el comportamiento entre los entornos local y de publicación
  • Inspeccionar solicitudes de red del explorador para comprobar la resolución de la URL
  • Compruebe si hay varias llamadas model.json en implementaciones de SPA
  • Revisar registros para asignar o reescribir la ejecución de reglas

Resolución resolution

Para solucionar el problema:

  1. Utilice reglas de reescritura de Dispatcher o CDN (como Apache mod_rewrite) para gestionar la eliminación de extensiones y el acortamiento de URL.
  2. Evite intentar asignar o reescribir fragmentos de URL (#), ya que no se procesan en el servidor.
  3. Asegúrese de que las canalizaciones de reescritura tengan valores de orden únicos y ámbitos de ruta distintos.
  4. No modifique las rutas reservadas por el sistema, como /experiments, ya que son necesarias para características específicas del producto.
  5. Actualice las asignaciones de Sling para garantizar que las URL cortas se resuelvan correctamente en las rutas de contenido interno, especialmente para implementaciones de SPA.
  6. Para las configuraciones on-premise, configure las reglas de reescritura a nivel de servidor para admitir la eliminación de extensiones.

Lectura relacionada

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