502 Bad Gateway ("плохой, ошибочный шлюз")

https://httpcat.ru/502

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

Описание

Код состояния 502 Bad Gateway означает, что сервер, действующий как шлюз или прокси, получил некорректный или недопустимый ответ от вышестоящего сервера при попытке обработать запрос.

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

Возникает на промежуточных серверах (например, Nginx, Cloudflare, API-шлюзах), которые передают запросы дальше
Означает, что следующий по цепочке сервер ответил с ошибкой, таймаутом или некорректным ответом
Ошибка находится **на стороне инфраструктуры**, а не клиента

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

GET /api/data HTTP/1.1
Host: example.com

HTTP/1.1 502 Bad Gateway
Content-Type: application/json

{
    "error": "Bad gateway",
    "message": "Upstream server returned an invalid response"
}

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

Content-Type — может возвращать пояснение от прокси или балансировщика
Via, X-Forwarded-For — могут помочь в диагностике цепочки проксирования

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

Когда сервер-посредник не может получить валидный ответ от вышестоящего сервера
При сбоях соединения между компонентами (API ↔ микросервис, CDN ↔ origin и т. п.)
Если вышестоящий сервер вернул недопустимый HTTP-ответ или вовсе не ответил

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

Популярен в Nginx, Cloudflare, AWS Gateway, Heroku и других платформах как индикатор сетевого сбоя
Отличие от 504 Gateway Timeout: 504 — таймаут, 502 — неправильный/битый ответ
Может быть вызван ошибками конфигурации, падением одного из сервисов или временной перегрузкой

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