Что такое 502 Bad Gateway? - коротко
502 Bad Gateway — это HTTP‑ошибка, указывающая, что сервер‑прокси не смог получить корректный ответ от целевого сервера. Чаще всего она возникает из‑за перегрузки, сбоя в работе бэкенда или неправильных сетевых настроек.
Что такое 502 Bad Gateway? - развернуто
502 Bad Gateway — это HTTP‑статус, который сервер возвращает клиенту, когда он не может получить корректный ответ от другого сервера, выступающего в роли шлюза или прокси. Ошибка свидетельствует о том, что запрос дошёл до промежуточного узла, но дальше связь нарушена, и конечный ресурс не был доставлен.
Основные причины возникновения такого кода:
- целевой сервер недоступен (выключен, перегружен, не отвечает);
- в цепочке запросов произошёл сбой соединения между шлюзом и upstream‑сервером;
- конфигурация прокси‑сервера содержит ошибку (неправильный адрес, порт, протокол);
- проблема с DNS: имя upstream‑сервера не разрешается или разрешается неверно;
- несовместимость протоколов (например, попытка передать HTTPS‑запрос через HTTP‑прокси без настройки TLS);
- программные ошибки в приложении, работающем за шлюзом (исключения, тайм‑ауты, неправильные заголовки).
Для пользователя 502 Bad Gateway выглядит как отказ в получении запрашиваемой страницы. Браузер обычно выводит сообщение об ошибке, но сам запрос был обработан корректно до уровня шлюза. Поэтому проблема, как правило, находится не на стороне клиента, а на серверной инфраструктуре.
Как можно реагировать на эту ошибку:
- Проверить состояние серверов. Убедиться, что все узлы, участвующие в обработке запроса, запущены и работают без перегрузки.
- Изучить журналы. Логи веб‑сервера, прокси и приложения часто содержат детали о тайм‑ауте, отказе соединения или некорректных ответах.
- Проверить конфигурацию. Убедиться, что адреса и порты upstream‑серверов указаны правильно, а протоколы согласованы.
- Тестировать DNS. Выполнить запросы к имени целевого сервера, убедиться в корректности записей.
- Перезапустить сервисы. Иногда простая перезагрузка веб‑сервера или прокси устраняет временные сбои.
- Обратиться к провайдеру. Если инфраструктура размещена у стороннего хостинга, стоит запросить статус их сервисов.
Отличие 502 Bad Gateway от схожих кодов:
- 500 Internal Server Error указывает на ошибку внутри самого сервера, который непосредственно обслуживает запрос.
- 504 Gateway Timeout появляется, когда шлюз смог связаться с upstream‑сервером, но тот не успел ответить в отведённое время.
- 503 Service Unavailable сообщает о недоступности сервиса из‑за перегрузки или планового обслуживания, без участия шлюза.
Итого, 502 Bad Gateway — это сигнал о проблеме в коммуникации между сервером‑шлюзом и сервером‑источником. Для устранения ошибки требуется диагностика серверной цепочки, проверка конфигураций и, при необходимости, взаимодействие с администратором или провайдером.