500 Internal Server Error ("внутренняя ошибка сервера")

https://httpcat.ru/500

Это прямая ссылка на изображение со статусом. Вы можете скопировать и использовать её где угодно.

Описание

Код состояния 500 Internal Server Error означает, что на сервере произошла внутренняя ошибка, из-за которой он не смог выполнить запрос. Это общая ошибка, не уточняющая конкретную причину сбоя.

Основные характеристики:

Обозначает непредвиденный сбой на сервере
Может быть вызван ошибкой в коде, неправильной конфигурацией, сбоем базы данных, исключением на сервере и т.д.
Сервер признаёт, что проблема — на его стороне, но не предоставляет подробностей

Типичное использование:

GET /dashboard HTTP/1.1
Host: example.com

HTTP/1.1 500 Internal Server Error
Content-Type: application/json

{
    "error": "An unexpected error occurred on the server"
}

Особенности заголовков:

Content-Type — может использоваться для передачи сообщения об ошибке
Retry-After — может быть добавлен, если ошибка временная

Когда использовать:

Если на сервере происходит исключение или сбой, который не обрабатывается специальным кодом
При сбоях в логике обработки запроса, проблемах с подключениями к БД или внешним сервисам
Когда нет смысла возвращать более конкретный код ошибки (например, 502, 503)

Дополнительно:

500 — это универсальный код ошибок сервера, своего рода «запасной вариант»
Разработчики и системные администраторы должны дополнительно анализировать логи сервера для выяснения причины
Если ошибка воспроизводится стабильно — стоит использовать более точный статус (например, 502 Bad Gateway, 503 Service Unavailable)

Документация: https://developer.mozilla.org/en-US/docs/Web/HTTP/Status/500