Ошибка

Вызывает ошибку в цепочке обработчиков HTTP, с необязательным сообщением и рекомендуемым кодом HTTP-статуса.

Этот обработчик не записывает ответ. Вместо этого он предназначен для использования с директивой handle_errors для вызова вашей пользовательской логики обработки ошибок.

Синтаксис

error [<matcher>] <status>|<message> [<status>] {
    message <text>
}

• <status> — код HTTP-статуса для записи. По умолчанию — 500.
• <message> — сообщение об ошибке. По умолчанию — нет сообщения об ошибке.
• message — альтернативный способ предоставления сообщения об ошибке; удобно, если оно состоит из нескольких строк.

Для ясности, первый аргумент, не являющийся соответствием, может быть либо трёхзначным кодом статуса, либо строкой сообщения об ошибке. Если это сообщение об ошибке, следующий аргумент может быть кодом статуса.

Примеры

Вызвать ошибку по определённым путям запроса и использовать handle_errors для записи ответа:

example.com {
	root * /srv	# Trigger errors for certain paths
    error /private* "Unauthorized" 403
	error /hidden* "Not found" 404    # Handle the error by serving an HTML page 
    handle_errors {
        rewrite * /{err.status_code}.html
		file_server
    }
	file_server
}