Páginas de Manipulador de Erro Personalizado | AEM

Para configurar manipuladores de erro personalizados no Adobe Experience Manager para renderizar diferentes erros HTTP, copie o script personalizado de /libs/sling/servlet/errorhandler para o mesmo local em /apps.

Descrição description

Ambiente

Adobe Experience Manager

Problema/Sintomas

Como criar scripts personalizados ou manipuladores de erros que renderizam diferentes erros HTTP?

Resolução resolution

Os scripts de manipulador de erros padrão estão localizados em /libs/sling/servlet/errorhandler.

Você pode sobrepor o tratamento de erros padrão copiando o script que gostaria de personalizar de /libs/sling/servlet/errorhandler para o mesmo local em /apps (ou seja, /apps/sling/servlet/errorhandler). Crie este caminho se ele não existir (por padrão, não existe).

Por exemplo, você pode personalizar o tratamento dos erros 404 copiando /libs/sling/servlet/errorhandler/404.jsp para /apps/sling/servlet/errorhandler/404.jsp

Os erros http 500 são causados por exceções do lado do servidor. Quando o processamento da solicitação resulta em uma exceção, o Apache Sling framework CQ é baseado em logs de exceção e retorna o código de erro http 500 e o rastreamento de pilha de exceção no corpo da resposta.

Para tratar erros 500, o nome de arquivo de um script de manipulador de erros deve ser igual à classe de exceção (ou sua superclasse). Assim, por exemplo, para lidar com todas as exceções, crie um script /apps/sling/servlet/errorhandler/Throwable.jsp.

Consulte Tratamento de erros de sling para obter mais informações.

Observação: o 500.jsp será usado somente se o HttpServletResponse.sendError(500) for executado explicitamente, ou seja, a partir de um receptor de exceção. Caso contrário, somente o código de resposta será definido como 500, mas o 500.jsp não será executado. Nesse caso, você pode adicionar uma Exception.jsp para lidar com todas essas exceções.

Observação: em uma instância de autor, o Filtro de Depuração CQ WCM está habilitado por padrão. Isso sempre leva a um código de resposta 200, e o Errorhandler padrão é usado para gravar o rastreamento de pilha completa para a resposta. Em uma instância de publicação, o Filtro de depuração CQ WCM está sempre desativado (também se você configurá-lo para ser ativado).