Anpassa sidor som visas av felhanteraren

Senast uppdaterad: 4 maj 2023

Skapat för:

  • Developer
CAUTION
AEM 6.4 har nått slutet på den utökade supporten och denna dokumentation är inte längre uppdaterad. Mer information finns i teknisk supportperiod. Hitta de versioner som stöds här.

AEM har en standardfelhanterare för hantering av HTTP-fel. genom att till exempel visa:

chlimage_1-67

Systemskript finns (under /libs/sling/servlet/errorhandler) för att svara på felkoder är som standard följande tillgängligt med en CQ-standardinstans:

  • 403.jsp
  • 404.jsp
NOTE
AEM baseras på Apache Sling, så se https://sling.apache.org/site/errorhandling.html om du vill ha mer information om felhantering vid körning.
NOTE
På en författarinstans CQ WCM-felsökningsfilter är aktiverat som standard. Detta resulterar alltid i svarskoden 200. Standardfelhanteraren svarar genom att skriva den fullständiga stackspårningen till svaret.
I en publiceringsinstans är CQ WCM-felsökningsfiltret alltid inaktiverat (även om det har konfigurerats som aktiverat).

Anpassa sidor som visas av felhanteraren

Du kan utveckla egna skript för att anpassa sidorna som visas i felhanteraren när ett fel inträffar. Dina anpassade sidor skapas under /apps och täcka över standardsidorna (som finns under /libs).

NOTE
Se Använda övertäckningar för mer information.

  1. Kopiera standardskripten i databasen:

    • från /libs/sling/servlet/errorhandler/
    • till /apps/sling/servlet/errorhandler/

    Eftersom målsökvägen inte finns som standard måste du skapa den första gången.

  2. Navigera till /apps/sling/servlet/errorhandler. Här kan du antingen:

    • redigera lämpligt skript för att ge den information som behövs.
    • skapa och redigera ett nytt skript för den kod som behövs.

  3. Spara ändringarna och testa.

CAUTION
Hanterarna 404.jsp och 403.jsp har utformats särskilt för att hantera CQ5-autentisering. särskilt för att möjliggöra systeminloggning vid dessa fel.
Därför bör dessa två hanterare bytas ut med stor försiktighet.

Anpassa svaret till HTTP 500-fel

HTTP 500-fel orsakas av serversidans undantag.

  • 500 internt serverfel
    Servern påträffade ett oväntat tillstånd som gjorde att den inte kunde slutföra begäran.

När bearbetningen av en begäran resulterar i ett undantag, är Apache Sling-ramverket (som AEM är inbyggt i):

  • loggar undantaget

  • returnerar:

    • HTTP-svarskod 500
    • stackspårning för undantag

    i svarets brödtext.

Av anpassa de sidor som visas i felhanteraren a 500.jsp kan skapas. Det används dock bara om HttpServletResponse.sendError(500) exekveras uttryckligen, d.v.s. från en undantagskatalog.

Annars är svarskoden inställd på 500, men 500.jsp skriptet körs inte.

Om du vill hantera 500 fel måste filnamnet för felhanterarskriptet vara detsamma som undantagsklassen (eller superklassen). Om du vill hantera alla sådana undantag kan du skapa ett skript /apps/sling/servlet/errorhandler/Throwable.jsp eller /apps/sling/servlet/errorhandler/Exception.jsp.

CAUTION
På en författarinstans CQ WCM-felsökningsfilter är aktiverat som standard. Detta resulterar alltid i svarskoden 200. Standardfelhanteraren svarar genom att skriva den fullständiga stackspårningen till svaret.
För en anpassad felhanterare behövs svar med koden 500, så CQ WCM Debug Filter måste inaktiveras. Detta garanterar att svarskoden 500 returneras, vilket i sin tur utlöser rätt Sling-felhanterare.
I en publiceringsinstans är CQ WCM-felsökningsfiltret alltid inaktiverat (även om det har konfigurerats som aktiverat).
Föregående sida
Nästa sida

Experience Manager