自定义错误页面 customizing-error-pages

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

主题：
开发中

创建对象：

管理员
开发人员

AEM附带了用于处理HTTP错误的标准错误处理程序；例如，通过显示：

标准错误消息

为了响应错误，AEM在/libs/sling/servlet/errorhandler下提供了404.jsp脚本。

TIP

由于AEM基于Apache Sling，因此Apache错误处理文档中提供了更多信息。

NOTE

在创作实例上，CQ WCM调试筛选器默认启用。这始终导致响应代码200。默认错误处理程序通过向响应写入完整栈栈跟踪来响应。

在发布实例上，CQ WCM调试筛选器为始终已禁用（即使配置为已启用）。

如何自定义错误处理程序显示的页面 how-to-customize-pages-shown-by-the-error-handler

您可以开发自己的脚本，以自定义遇到错误时错误处理程序显示的页面。为此，您需要使用AEM的标准叠加机制，以便在/apps下创建自定义页面，并叠加在/libs下的默认页面。

在存储库中，复制默认脚本：
- 从 /libs/sling/servlet/errorhandler/
- 至/apps/sling/servlet/errorhandler/
默认情况下，目标路径不存在，因此，在首次执行该操作时，您需要创建该路径。
导航到/apps/sling/servlet/errorhandler。在此，您可以：
- 编辑相应的现有脚本以提供所需的信息。或者
- 为所需代码创建和编辑新脚本。
保存更改并进行测试。

CAUTION

404.jsp脚本专门设计用于满足AEM身份验证；特别是允许出现这些错误时进行系统登录。

因此，替换此脚本时应非常小心。

自定义对HTTP 500错误的响应 customizing-the-response-to-http-errors

HTTP 500内部服务器错误表示服务器端错误，例如服务器遇到意外情况，导致它无法完成请求。

当请求处理导致异常时，Apache Sling框架(AEM构建于之上)：

记录异常
并在响应正文中返回：
- HTTP响应代码500
- 异常栈栈跟踪

通过自定义错误处理程序显示的页面，可以创建500.jsp脚本。但是，仅当显式执行HttpServletResponse.sendError(500)时（即，从异常捕获器）才使用它。

否则，响应代码设置为500，但不执行500.jsp脚本。

要处理500个错误，错误处理程序脚本的文件名必须与异常类（或超类）相同。若要处理所有此类异常，可创建脚本/apps/sling/servlet/errorhandler/Throwable.jsp或/apps/sling/servlet/errorhandler/Exception.jsp。

NOTE

在AEMCloud Service中，当从后端收到5XX错误时，CDN会提供一个通用错误页面。要允许后端的实际响应通过，您需要将以下标头添加到响应： x-aem-error-pass: true。
这仅适用于来自AEM或Apache/Dispatcher层的响应。来自中间基础架构层的其他意外错误仍会显示常规错误页面。

CAUTION

在创作实例上，CQ WCM调试筛选器默认启用。这始终导致响应代码200。默认错误处理程序通过向响应写入完整栈栈跟踪来响应。

对于自定义错误处理程序，需要代码为500的响应，因此必须禁用CQ WCM调试过滤器。这可确保返回响应代码500，这反过来会触发正确的Sling错误处理程序。

在发布实例上，CQ WCM调试筛选器为始终已禁用（即使配置为已启用）。

recommendation-more-help

fbcff2a9-b6fe-4574-b04a-21e75df764ab