Personalizar páginas mostradas por el controlador de error customizing-pages-shown-by-the-error-handler

Adobe Experience Manager AEM () viene con un controlador de error estándar para administrar errores HTTP; por ejemplo, mostrando:

chlimage_1-67

Los scripts proporcionados por el sistema existen (en /libs/sling/servlet/errorhandler) para responder a códigos de error. De forma predeterminada, los siguientes scripts están disponibles con una instancia de CQ estándar:

  • 403.jsp
  • 404.jsp
NOTE
AEM Se basa en Apache Sling. Como tal, consulte Control de errores para obtener información detallada sobre el control de errores de Sling.
NOTE
En una instancia de autor, el filtro de depuración de CQ WCM está habilitado de manera predeterminada. Esto siempre resulta en el código de respuesta 200. El controlador de error predeterminado responde escribiendo el seguimiento de pila completo en la respuesta.
En una instancia de publicación, el filtro de depuración de CQ WCM está siempre deshabilitado (incluso si está configurado como habilitado).

Personalizar páginas mostradas por el controlador de error how-to-customize-pages-shown-by-the-error-handler

Puede desarrollar sus propias secuencias de comandos para personalizar las páginas que muestra el controlador de errores cuando se produce un error. Sus páginas personalizadas se crean en /apps y se superponen a las páginas predeterminadas (que se encuentran en /libs).

NOTE
Consulte Uso de superposiciones para obtener más información.
  1. En el repositorio, copie los scripts predeterminados:

    • de /libs/sling/servlet/errorhandler/
    • hasta /apps/sling/servlet/errorhandler/

    Como la ruta de destino no existe de forma predeterminada, debe crearla al hacerlo por primera vez.

  2. Vaya a /apps/sling/servlet/errorhandler y realice una de las acciones siguientes:

    • edite la secuencia de comandos existente adecuada para poder proporcionar la información necesaria.
    • cree y edite un nuevo script para el código requerido.
  3. Guarde los cambios y pruebe.

CAUTION
Los controladores 404.jsp y 403.jsp se han diseñado para adaptarse a la autenticación CQ5; en particular, para permitir el inicio de sesión en el sistema si se producen estos errores.
Por lo tanto, la sustitución de estos dos controladores debe realizarse con mucho cuidado.

Personalización de la Respuesta a Errores HTTP 500 customizing-the-response-to-http-errors

Los errores de HTTP 500 se deben a excepciones del lado del servidor.

AEM Cuando el procesamiento de solicitudes resulta en una excepción, el marco de trabajo de Apache Sling (en el que se basa ese):

  • registra la excepción

  • devuelve:

    • el código de respuesta HTTP 500
    • el seguimiento de pila de excepciones

    en el cuerpo de la respuesta.

Si personaliza las páginas mostradas por el controlador de error, se puede crear un script 500.jsp. Sin embargo, solo se usa si HttpServletResponse.sendError(500) se ejecuta explícitamente; es decir, desde un receptor de excepciones.

De lo contrario, el código de respuesta se establece en 500, pero no se ejecuta el script 500.jsp.

Para controlar 500 errores, el nombre de archivo de la secuencia de comandos del controlador de errores debe ser el mismo que la clase de excepción (o superclase). Para controlar todas estas excepciones, puede crear un script /apps/sling/servlet/errorhandler/Throwable.jsp o /apps/sling/servlet/errorhandler/Exception.jsp.

CAUTION
En una instancia de autor, el filtro de depuración de CQ WCM está habilitado de manera predeterminada. Esto siempre resulta en el código de respuesta 200. El controlador de error predeterminado responde escribiendo el seguimiento de pila completo en la respuesta.
Para un controlador de error personalizado, se necesitan respuestas con código 500, por lo que el filtro de depuración de CQ WCM debe deshabilitarse. Esto garantiza que se devuelva el código de respuesta 500, lo que a su vez déclencheur el controlador de error de Sling correcto.
En una instancia de publicación, el filtro de depuración de CQ WCM está siempre deshabilitado (incluso si está configurado como habilitado).
recommendation-more-help
19ffd973-7af2-44d0-84b5-d547b0dffee2