DocumentaçãoAEM 6.5Guia do usuário

Personalizar páginas mostradas pelo Manipulador de erros customizing-pages-shown-by-the-error-handler

Last update: Mon Jul 15 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

Criado para:

  • Desenvolvedor

O Adobe Experience Manager (AEM) vem com um manipulador de erros padrão para lidar com erros HTTP; por exemplo, mostrando:

chlimage_1-67

Existem scripts fornecidos pelo sistema (em /libs/sling/servlet/errorhandler) para responder a códigos de erro; por padrão, os seguintes estão disponíveis com uma instância CQ padrão:

  • 403.jsp
  • 404.jsp
NOTE
O AEM é baseado no Apache Sling. Dessa forma, consulte Tratamento de erros para obter informações detalhadas sobre a manipulação de erros de Sling.
NOTE
Em uma instância de autor, o Filtro de Depuração WCM do CQ está habilitado por padrão. Isso sempre resulta no código de resposta 200. O manipulador de erros padrão responde gravando o rastreamento de pilha completa na resposta.
Em uma instância de publicação, o Filtro de Depuração CQ WCM está sempre desabilitado (mesmo se configurado como habilitado).

Como personalizar páginas mostradas pelo manipulador de erros how-to-customize-pages-shown-by-the-error-handler

Você pode desenvolver seus próprios scripts para personalizar as páginas mostradas pelo manipulador de erros quando um erro for encontrado. Suas páginas personalizadas são criadas em /apps e sobrepõem as páginas padrão (que estão em /libs).

NOTE
Consulte Usando Sobreposições para obter mais detalhes.

  1. No repositório, copie os scripts padrão:

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

    Como o caminho de destino não existe por padrão, você deve criá-lo ao fazer isso pela primeira vez.

  2. Navegue até /apps/sling/servlet/errorhandler e execute um dos procedimentos a seguir:

    • edite o script existente apropriado para que você possa fornecer as informações necessárias.
    • crie e edite um novo script para o código necessário.

  3. Salve as alterações e teste.

CAUTION
Os manipuladores 404.jsp e 403.jsp foram projetados para atender à autenticação CQ5; em particular, para permitir o logon do sistema se houver esses erros.
Portanto, a substituição desses dois manipuladores deve ser feita com muito cuidado.

Personalização da resposta a erros HTTP 500 customizing-the-response-to-http-errors

Os erros HTTP 500 são causados por exceções do lado do servidor.

Quando o processamento de solicitações resulta em uma exceção, a estrutura do Apache Sling (em que o AEM está integrado):

  • registra a exceção

  • devoluções:

    • o código de resposta HTTP 500
    • o rastreamento de pilha de exceção

    no corpo da resposta.

Com a personalização das páginas mostradas pelo manipulador de erros, um script 500.jsp pode ser criado. No entanto, ele só é usado se HttpServletResponse.sendError(500) for executado explicitamente; ou seja, a partir de um capturador de exceção.

Caso contrário, o código de resposta será definido como 500, mas o script 500.jsp não será executado.

Para tratar erros 500, o nome de arquivo do script do manipulador de erros deve ser igual à classe de exceção (ou superclasse). Para lidar com todas essas exceções, você pode criar um script /apps/sling/servlet/errorhandler/Throwable.jsp ou /apps/sling/servlet/errorhandler/Exception.jsp.

CAUTION
Em uma instância de autor, o Filtro de Depuração WCM do CQ está habilitado por padrão. Isso sempre resulta no código de resposta 200. O manipulador de erros padrão responde gravando o rastreamento de pilha completa na resposta.
Para um manipulador de erros personalizado, são necessárias respostas com o código 500; portanto, o Filtro de Depuração WCM do CQ deve ser desabilitado. Isso garante que o código de resposta 500 seja retornado, o que, por sua vez, aciona o manipulador de erros Sling correto.
Em uma instância de publicação, o Filtro de Depuração CQ WCM está sempre desabilitado (mesmo se configurado como habilitado).
recommendation-more-help
19ffd973-7af2-44d0-84b5-d547b0dffee2