Personalización de páginas mostradas por el controlador de errores

AEM viene con un controlador de error estándar para controlar los errores HTTP; por ejemplo, mostrando:

Existen secuencias de comandos proporcionadas por el sistema (en /libs/sling/servlet/errorhandler) para responder a códigos de error; de forma predeterminada, las siguientes están disponibles con una instancia de CQ estándar:

• 403.jsp
• 404.jsp

Cómo personalizar páginas mostradas por el controlador de errores

Puede desarrollar sus propias secuencias de comandos para personalizar las páginas que muestra el controlador de errores cuando se encuentra un error. Las páginas personalizadas se crearán en /apps y superpondrán las páginas predeterminadas (que se encuentran en /libs).

1. En el repositorio, copie las secuencias de comandos predeterminadas:

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

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

2. Ir a /apps/sling/servlet/errorhandler. Aquí puede:

   • edite la secuencia de comandos existente adecuada para proporcionar la información requerida.
   • cree y edite una nueva secuencia de comandos para el código requerido.

3. Guarde los cambios y pruebe.

Personalización de la respuesta a los errores HTTP 500

Los errores HTTP 500 son causados por excepciones del lado del servidor.

• 500
  Error interno del servidorEl servidor encontró una condición inesperada que impedía que cumpliera la solicitud.

Cuando el procesamiento de la solicitud resulta en una excepción, el marco de Apache Sling (en el que AEM está integrado):

• registra la excepción

• devuelve:

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

  en el cuerpo de la respuesta.

Al personalizar las páginas que muestra el controlador de errores se puede crear una secuencia de comandos 500.jsp. Sin embargo, sólo se utiliza si HttpServletResponse.sendError(500) se ejecuta explícitamente; es decir, desde un captador de excepciones.

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

Para gestionar errores 500, 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 gestionar todas estas excepciones, puede crear una secuencia de comandos /apps/sling/servlet/errorhandler/Throwable.jsp o /apps/sling/servlet/errorhandler/Exception.jsp.