文档
一个 项目

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
}