502 Bad Gateway: ошибка шлюза

Ошибка 502 Bad Gateway означает, что промежуточный сервер — обратный прокси, CDN или балансировщик нагрузки — получил некорректный ответ от вышестоящего origin-сервера, для которого он проксирует запросы.

Что это значит

Пользователь (или краулер) общается со шлюзом, а шлюз — с origin-сервером. Ошибка 502 означает, что сбой случился на втором переходе: origin упал, не ответил вовремя, закрыл соединение или вернул некорректные данные. Сам шлюз обычно в порядке.

Частые причины

  • Процессы origin падают или прерываются посреди запроса (баги в деплое, фатальные ошибки PHP или Python).
  • Таймауты origin под нагрузкой: шлюз сдаётся раньше, чем приложение успевает ответить.
  • Исчерпание ресурсов: пулы подключений к базе данных, воркеры, память.
  • Несовпадение конфигурации после деплоя: неверный порт, протокол или имя upstream.

Почему это важно для SEO

Поисковые краулеры, получив 502, считают URL временно недоступными и возвращаются позже. Устойчивые 502 приводят к удалению из индекса так же, как 500. Поскольку 502 часто идут всплесками (пики трафика, деплои), важнее отслеживать коды ответов во времени, чем судить по одному сканированию.

Сопоставьте частоту 502 в логах с временем деплоев и кривой трафика: совпадение обычно сразу показывает виновника.

FAQ

Это проблема на стороне клиента?
Нет. Ни браузер, ни краулер не могут её исправить. Сбой происходит между шлюзом и origin-сервером.
Как отличить 502 от 503 и 504?
502: origin вернул некорректный ответ. 503: сервер сам объявляет себя недоступным (часто с заголовком Retry-After). 504: origin вообще не ответил вовремя.