Anpassa felsidor

Senaste uppdatering: 2023-11-18

AEM innehåller en standardfelhanterare för hantering av HTTP-fel, till exempel genom att visa:

Standardfelmeddelande

För att svara på fel finns AEM en 404.jsp skript under /libs/sling/servlet/errorhandler.

TIPS

Eftersom AEM baseras på Apache Sling finns mer information tillgänglig i dokumentationen för felhantering i Apache.

OBSERVERA

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. För att göra detta använder du AEM standardövertäckningsmekanism så att dina anpassade sidor skapas under /apps och täcka över standardsidorna under /libs.

  1. Kopiera standardskripten i databasen:

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

    Målsökvägen finns inte som standard, så du måste 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. eller
    • skapa och redigera ett nytt skript för den kod som behövs.

  3. Spara ändringarna och testa.

FÖRSIKTIGHET

The 404.jsp skriptet har utformats särskilt för att AEM autentiseringen, särskilt för att tillåta systeminloggning vid dessa fel.

Därför bör det här manuset ersättas med stor omsorg.

Anpassa svaret till HTTP 500-fel

HTTP 500 internt serverfel indikerar ett fel på serversidan, t.ex. att servern råkade ut för ett oväntat tillstånd som gjorde att den inte kunde utföra begäran.

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

  • Loggar undantaget
  • Och returnerar i svarstexten:
    • HTTP-svarskoden 500
    • Undantagets stackspårning

Av anpassa de sidor som visas i felhanteraren a 500.jsp kan skapas. Det används dock bara om HttpServletResponse.sendError(500) körs explicit, det vill säga 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.

OBSERVERA

I AEM som Cloud Service visar CDN en allmän felsida när ett 5XX-fel tas emot från serverdelen. Om du vill att det faktiska svaret från backend ska gå igenom måste du lägga till följande rubrik i svaret: x-aem-error-pass: true.
Detta fungerar bara för svar från AEM eller lagret Apache/Dispatcher. Andra oväntade fel från mellanliggande infrastrukturlager visar fortfarande den allmänna felsidan.

FÖRSIKTIGHET

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
Next page

På denna sida