AEM附带用于处理HTTP错误的标准错误处理程序;例如,通过显示:
系统提供的脚本存在(在/libs/sling/servlet/errorhandler
下)以响应错误代码,默认情况下,标准CQ实例提供以下脚本:
AEM基于Apache Sling,因此请参阅https://sling.apache.org/site/errorhandling.html了解有关Sling错误处理的详细信息。
在创作实例上,默认情况下启用CQ WCM调试过滤器。 这始终导致响应代码为200。 默认错误处理程序通过将整个堆栈跟踪写入响应进行响应。
在发布实例上,CQ WCM调试过滤器始终**处于禁用状态(即使配置为启用)。
您可以开发自己的脚本,以在遇到错误时自定义错误处理程序显示的页面。 您的自定义页面将在/apps
下创建,并覆盖默认页面(在/libs
下)。
有关详细信息,请参阅使用叠加。
在存储库中,复制默认脚本:
/libs/sling/servlet/errorhandler/
/apps/sling/servlet/errorhandler/
由于目标路径默认不存在,因此您首次执行此操作时需要创建它。
导航至 /apps/sling/servlet/errorhandler
. 您可以在此处:
保存更改并测试。
404.jsp和403.jsp处理程序专门设计用于满足CQ5身份验证要求;特别是,在出现这些错误时允许系统登录。
因此,更换这两个操纵者,应当非常谨慎。
HTTP 500错误由服务器端异常引起。
当请求处理导致异常时,Apache Sling Framework(AEM基于):
记录异常
返回:
在响应中。
通过自定义错误处理程序显示的页面,可以创建500.jsp
脚本。 但是,仅当显式执行HttpServletResponse.sendError(500)
时才使用它;例如从例外捕手那里。
否则,响应代码设置为500,但不执行500.jsp
脚本。
要处理500个错误,错误处理程序脚本的文件名必须与异常类(或超类)相同。 要处理所有此类异常,可创建脚本/apps/sling/servlet/errorhandler/Throwable.js
p或/apps/sling/servlet/errorhandler/Exception.jsp
。
在创作实例上,默认情况下启用CQ WCM调试过滤器。 这始终导致响应代码为200。 默认错误处理程序通过将整个堆栈跟踪写入响应进行响应。
对于自定义错误处理程序,需要代码为500的响应——因此需要禁用CQ WCM调试过滤器。 这确保返回响应代码500,这反过来又触发正确的Sling错误处理程序。
在发布实例上,CQ WCM调试过滤器始终**处于禁用状态(即使配置为启用)。