error
在 HTTP 处理器链中触发错误,带有可选的消息和推荐的 HTTP 状态码。
此处理器不会写入响应。相反,它旨在与 handle_errors
指令配对,以调用您的自定义错误处理逻辑。
语法
error [<matcher>] <status>|<message> [<status>] {
message <text>
}
- <status> 是要写入的 HTTP 状态码。默认为
500
。 - <message> 是错误消息。默认为无错误消息。
- message 是提供错误消息的替代方式;如果消息是多行的,则很方便。
为了澄清,第一个非匹配器参数可以是 3 位数字状态码,或错误消息字符串。如果是错误消息,则下一个参数可以是状态码。
示例
在某些请求路径上触发错误,并使用 handle_errors
写入响应:
example.com {
root * /srv
# 为某些路径触发错误
error /private* "Unauthorized" 403
error /hidden* "Not found" 404
# 通过提供 HTML 页面处理错误
handle_errors {
rewrite * /{err.status_code}.html
file_server
}
file_server
}